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本 书 帮助 你 将 Web 开 发 技能 从 浏览 器 端 转向 Node 服 务 器 ， 并 且 学 习 
如 何 使 用 Node 这 种 基于 JavaScript 的 平台 编写 出 快速 和 高 可 扩展 性 的 
网 络 应 用 。 在 本 书 的 指导 下 ， 你 可 以 快速 掌握 Node 的 核心 技能 ， 获 
得 使 用 内 建 和 扩展 模块 的 经 验 ， 并 了 解 客户 端 编程 和 服务 器 端 编程 
的 不 同和 相同 之 处 。 

为 了 加 快 Node 事 件 驱 动 的 速度 ， 在 开发 计算 简单 但 是 访问 频繁 的 数 
据 密集 型 程序 时 ， 可 以 使 用 异步 的 VO 模型 。 


如 末 你 豆 欢 使 用 JavaScript， 本 书 提供 了 很 多 代码 和 开发 的 示例 来 帮 
助 你 学 习 Node 服 务 左 端的 开发 。 


m 探索 Node 独 特 的 异步 开发 的 实现 方式 ; 
使 用 Express 架 构 和 Connect 中 间 件 构建 Node 应 用 示例 ， 


m 使 用 NoSQL 解 决 方案 ， 比 如 Redis 和 MongoDB ， 探 索 Node 
的 关系 数据 库 模块 ， 


使 用 PDF 文件 ， 提 供 HTML5 媒 体 ， 使 用 Canvas 创 建 图 形 ， 
使 用 WebSockets 创 建 浏览 器 和 服务 器 的 双向 通信 ， 

深入 学 习 如 何 调试 和 测试 程序 ， 

在 云 服 务 器 或 者 自己 的 系统 上 部 署 Node 应 用 程序 。 


Shelley Powers 从 JavaScript 刚 发 布 时 ， 就 开始 使 用 和 编写 Web 技 
术 相 关 书 籍 。 她 之 前 在 OReilly 出 版 了 8 本 书 ， 包括 Developing 
ASP Components (2001) , Adding Ajax (2007) 和 JavaScript 
Cookbook (2010) , 
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Node.js 是 一 套用 来 编写 高 性 能 网 络 服务 器 的 JavaScript 工具 包 。 它 可 以 让 
JavaScript 在 服务 器 端 运行 ， 因 此 ， 可 用 来 快速 构建 网 络 服务 及 应 用 的 平台 。 

本 书 是 学 习 Node 编程 的 入 门 指南 。 全 书 共 16 章 。 前 4 章 主要 介绍 Node 
基本 知识 ， 包 管理 工具 (npm) 的 安装 和 使 用 等 。 第 5 章 介 绍 了 Node 处 理 异 步 
开发 的 独特 的 实现 方式 等 。 第 6~8 章 ， 讲 解 了 路 由 、 代 理 、Web 服务 器 、 中 间 
件 等 基本 概念 ,包括 Express。 第 9 章 到 第 11 章 分 别 介绍 了 基于 Redis, MongoDB 
以 及 关系 型 数据 库 的 Node 应 用 开发 。 第 12 章 到 第 14 章 分 别 介 绍 了 图 形 和 媒 
体 、Sockets.io 模块 、 调 试 和 测试 等 主题 。 第 15 章 介 绍 了 安全 和 权限 的 问题 ， 
第 16 章 介 绍 了 Node 应 用 的 扩展 和 部 署 。 

本 书 适 合 有 一 定 基 础 的 Javascript 程序 员 阅 读 , 也 适合 对 学 习 Node 应 用 开 
发 感 兴趣 的 读者 学 习 参 考 。 
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非 同 寻常 的 JavaScript 
目前 正 是 学 习 Node 的 好 时 机 。 


Node 相关 的 技术 依然 年 轻 充满 生机 ， 经 党 出 现 有 趣 的 变化 和 改动 。 同 时 ， 这 项 技 
术 也 达到 了 一 定 的 成 熟 度 ， 可 以 确保 你 在 学 习 Node 上 人 花费 的 时 间 是 值得 的 : 即使 
在 Windows 上 安 次 也 非常 简单 ; 从 成 百 上 千 的 可 用 模块 中 涌现 出 了 最 佳 组 合 模块 ， 
对 于 产品 环境 来 说 这 种 结构 足够 健壮 。 


当 使 用 Node 时 需要 记得 两 个 要 点 。 第 一 ，Node 是 基于 JavaScript 的 ， 与 你 之 前 用 
于 客户 端 开 发 的 JavaScript 多 少 有 些 类 似 。 当然 , 你 也 可 以 使 用 另 一 种 变形 的 语言 ， 
如 CoffeeScript， 但 是 JavaScript 是 通用 的 语言 。 


第 二 个 需要 注意 的 要 点 是 ，Node 并 不 是 和 常规 的 JavaScript。 它 是 一 门 服务 器 端的 技 
术 , 这 意味 着 很 多 你 在 浏览 器 环境 中 认为 应 该 有 的 功能 一 一 如 保护 措施 一 一 都 不 会 
出 现在 这 里 ,但 也 会 有 很 多 其 他 新 的 不 熟悉 的 功能 。 


当然 ， 如 果 Node 和 浏览 右 端 的 JavaScript 一 样 的 话 ， 那 有 什么 乐趣 呢 ? 


为 什么 是 Node 

如 果 你 想 要 看 Node 的 源码 ， 你 可 以 找 一 下 Google V8 的 源 代码 。Google V8 是 
JavaScript 引 敬 (从 技术 角度 来 讲 ， 是 ECMAScript), ， 也 是 Google Chrome 浏览 器 
的 核心 。 那 么 ，Nodejjs 的 一 个 优点 是 你 可 以 只 为 一 种 JavaScript 实现 开发 Node 程 
序 ， 而 不 是 一 大 堆 不 同 版 本 的 不 同 浏览 器 。 


Node 被 设计 用 于 那些 需要 频繁 1/O 操作 , 但 计算 量 不 大 的 程序 。 更 重要 的 是 ， 
它 提供 的 这 个 功能 是 直接 可 用 的 。 在 等 待 一 个 文件 加 载 完 成 或 者 数据 库 更 新 
的 过 程 中 , 不 需要 担心 程序 会 阻塞 其 他 进程 ， 因 为 Node 中 大 部 分 功能 默认 都 
是 IO 异步 的 ， 也 不 需要 担心 线程 的 工作 ， 因 为 Node 的 实现 是 单线 
程 的 。 








pir 异步 VO 意味 着 程序 并 不 会 等 待 输入 /输出 操作 处 理 完 成 之 后 才 处 理 
代码 中 的 下 一 个 步骤 。 第 1 章 会 介绍 更 多 Node 异步 特性 的 细节 。 
«} 


更 重要 的 一 点 是 ，Node 是 由 很 多 传统 Web 开发 人 员 都 熟悉 的 语言 JavaScript 编写 
的 。 你 会 学 习 到 如 何 使 用 新 的 技术 ， 如 WebSocket 或 者 基于 Express 这 种 框架 进行 
开发 , 但 是 至 少 你 不 需要 在 学 习 新 概念 的 同时 学 习 一 门 新 的 语言 。 对 语言 的 熟悉 使 
你 可 以 只 专注 新 的 特性 。 


本 书 的 目标 读者 

使 用 Node 的 一 个 挑战 就 是 假设 学 习 Node 的 部 分 人 有 Ruby 或 者 Python 背景 ， 或 
者 使 用 过 Redis。 我 没有 假定 这 一 点 ， 所 以 在 解释 Node 组 件 时 我 不 会 说 这 就 “ 像 
Sinatra 一 样 ”。 


这 本 书 唯 一 的 假设 就 是 读者 使 用 过 JavaScript 并 且 嘉 欢 它 。 你 并 不 需要 是 个 专家 ， 
但 是 你 需要 在 我 提 到 “ 闭 包 ” 的 时 候 知 道 我 在 说 什么 ， 并 且 使 用 过 Ajax 以 及 对 客 
户 端 环 境 的 事件 处 理 比 较 熟 悉 。 如 果 你 做 过 传统 的 Web 开发 ， 熟 悉 一 些 概念 ， 如 
HTTP 方法 (GET, POST), Web session, cookie 等 ， 你 会 从 本 书 中 获 益 良 多 。 除 
了 这 些 ， 你 需要 熟悉 Windows Feit] S, BK Unix, Linux, MAC OSX 的 命令 行 。 


如 果 你 对 一 些 新 技术 感 兴趣 , 诸如 WebSocket 或 者 使 用 架构 创建 程序 , 就 会 喜欢 这 
本 书 的 。 我 通过 这 些 方面 向 你 介绍 如 何在 现实 世界 使 用 Node, 


最 重要 的 一 点 ,在 你 阅读 本 书 时 要 保持 思维 开放 ， 要 有 思想 准备 、 你 可 能 碰 上 版 本 
不 成 熟 的 问题 ， 也 可 能 会 撞 上 这 种 处 在 发 展 中 的 技术 陷阱 。 无 论 如 何 ， 带 着 期 符 开 
始 你 的 学 习 旅 程 吧 ， 因 为 这 是 一 个 很 有 趣 的 过 程 。 


如 果 你 不 确定 你 达到 了 “熟悉 ”JavaScript 的 标准 ， 可 以 查看 一 下 我 
对 JavaScript 的 介绍 : Learning JavaScrpt， 第 二 版 (O’ Reilly )。 





怎么 更 好 地 使 用 本 书 
如 果 你 不 想 按 顺 序 阅 读本 书 ， 有 一 些 途 径 可 供 选 择 , 这 取决 于 你 想 要 知道 些 什么 以 
及 你 有 多 少 Node 经 验 。 


如 果 你 从 来 没有 用 过 Node， 建 议 你 从 第 1 章 开 始 阅读 至 少 到 第 5 Et, LEER 
HT Node 基本 知识 、 包 管理 工具 (npm) 安装 、 如 何 使 用 、 创 建 你 的 第 一 个 程序 


N 
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以 及 可 用 的 模块 。 第 5 章 还 涉及 了 一 些 Node 中 的 样式 问题 ， 包 括 Node 处 理 异 步 
开发 的 独特 实现 方式 。 


GAR KA A Node 经 验 ， 使 用 过 内 建 和 第 三 方 的 一 些 模块 ， 也 熟悉 REPL 
(read-eval-print loop， 交 互 .控制 台 )， 可 以 跳 过 第 1 草 到 第 4 章 ， 但 是 我 建议 第 5 章 
还 是 必 读 的 。 


在 本 书 中 ,我 使 用 了 Express 架构 ，Express 又 使 用 了 Connect 中 间 件 。 如 果 你 没 用 
过 Express， 请 阅读 第 6 一 第 8 章 ， 这 几 章 讲解 了 路 由 、 人 代理、Web IRAE. FIA] 
件 等 基本 概念 ， 包 括 Express。 尤 其 是 如 果 你 好 奇 在 MVC (Model-View-Controller) 
框架 中 如 何 使 用 Express， 一 定 要 阅读 第 7 章 和 第 8 章 。 


在 这 些 基础 章节 之 后 , 你 可 以 有 选择 地 进行 阅读 。 比 如 , 如 果 你 主要 使 用 key/value 
( 键 值 对 ) , 你 应 该 阅读 第 9 章 关 于 Redis 的 讨论 。 如 果 你 对 基于 文档 的 数据 感 兴 趣 ， 
查阅 第 10 章 ， 这 一 章 介 绍 了 如 何在 Node 中 使 用 MongoDB。 当 然 ， 如 果 你 只 需要 
使 用 关系 型 数据 库 , 可 以 直接 跳 过 Redis 和 MongoDB 到 第 11 章 , 记得 经 常 检查 数 
据 库 的 更 新 一 一 它们 可 能 提供 了 一 种 处 理 数 据 的 新 视角 。 


在 这 三 章 关 于 数据 的 讲解 之 后 ， 我 们 会 介绍 具体 程序 的 使 用 。 第 12 章 主要 关注 于 
图 形 和 媒体 访问 , 包括 如 何 提供 HTML5 视频 媒体 , 以 及 使 用 Canvas 和 PDF 文件 。 
第 13 章 主要 讲 了 非常 流行 的 Sockets.io 模块 ,特别 是 如 何 使 用 新 的 web socket 功能 。 


在 第 12 章 和 第 13 章 两 章 关 于 Node 两 种 不 同 的 具体 用 法 介绍 之 后 ， 本 书 末 尾 再 次 
回 到 同一 点 上 。 当 你 在 其 他 章节 花费 了 一 些 时 间 尝 试 示例 之 后 ， 需 要 读 一 下 第 14 
章 ， 深 入 了 解 如 何 调 试 和 测试 Node 程序 。 


第 15 章 可 能 是 最 难 的 一 章 ， 也 更 重要 。 这 一 章 主 要 介绍 了 安全 和 权限 的 问题 。 我 
不 建议 把 这 章 作为 你 阅读 的 第 一 章 ， 但 是 在 你 发 布 一 个 Node 应 用 之 前 需要 花 点 时 
间 读 一 下 这 一 章节 。 


第 16 章 是 最 后 一 章 ， 不 管 你 兴趣 是 什么 、 经 验 多 少 ， 你 都 可 以 很 放心 地 把 它 留 到 
最 后 。 这 章 主 要 介绍 如 何 使 你 的 产品 上 线 , 包括 如 何在 流行 的 云 服 务 上 或 者 你 目 己 
的 系统 中 部 署 Node 程序 ， 如 何 确保 你 的 程序 可 以 与 其 他 Web 服务 器 兼容 ， 比 如 
Apache， 如 何 确 保 你 的 程序 在 崩 演 或 者 系统 重启 之 后 目 动 重启 。 


Node 与 Git 版 本 控制 联系 紧密 ， 并且 绝 大 部 分 (如 果 不 是 全 部 的 话 ) 的 Node 模块 
都 在 GitHub 上 。 附 录 里 为 那些 不 了 解 Git/GitHub 的 人 提供 了 教程 。 


虽然 我 之 前 说 不 需要 按 章节 进行 阅读 , 但 是 我 建议 你 还 是 按 顺 序 阅读 。 很 多 革 市 的 


工作 都 是 在 前 一 章 的 基础 上 完成 , 如 果 你 跳跃 阅读 的 话 可 能 会 错过 一 些 重点 。 尽 管 
本 书 有 很 多 独立 的 程序 示例 ， 但 是 我 主要 使 用 了 一 个 简单 的 Express 程序 一 一 叫做 
Widget Factory， 从 第 7 章 开 始 ， 在 剩 下 的 章节 中 都 有 涉及 。 我 相信 如 果 你 从 开始 
阅读 ， 跳 过 那些 你 了 解 的 小 市 会 比 跳 过 整个 章节 好 很 多 。 


就 像 《 爱 丽 丝 漫 游 奇 境 记 》 里 的 国王 说 的 一 样 : 从 “开头 开始 ， 一 直 念 到 末尾 ， 
然后 停止 。 


技术 


本 书 中 的 示例 是 在 Node 0.6.x 不 同 的 发 布 版 本 中 创建 的 , 大 部 分 部 在 Linux 环境 中 
测试 过 ， 应 该 在 各 种 Node 环境 中 都 可 以 正常 工作 。 


Node 0.8.x 发 布 的 时 候 本 书 刚 刚 上 市 。 大 部 分 示例 都 兼容 Node 0.8.x。 有 一 些 例子 
需要 做 一 些 修改 以 兼容 新 版 Node， 我 在 书 中 也 有 指出 。 


示例 

本 书 中 的 所 有 示例 在 O?Reilly 官网 本 书 主 页 上 (http://oreil.ly/Learning node) 有 压 
缩 文件 可 以 下 载 。 下 载 解压 ， 安 装 好 Node 之 后 ， 可 以 切换 examples 目录 ， 输 入 以 
下 命令 来 安装 示例 需要 的 所 有 依赖 : 


npm install-d 

在 第 4 章 中 我 会 讲 到 更 多 关于 npm 的 用 法 。 

本 书 中 的 体例 

以 下 是 本 书 中 使 用 的 印刷 体例 ， 

文本 

菜单 标题 ， 菜 单 选项 ， 菜 单 按钮 ， 键 盘 快捷 键 (比如 Alt 和 Ct), 
等 宽 字体 


命令 ， VENI, switch, 变量 , JAE, key, RM, BA, KR, MAB, WR, BR, 
参数 ， 值 ， 对 象 ， 事 件 ， 事 件 处 理 ，XML 标记 ，HTML 标记 ， 宏 ， 文 件 内 容 或 者 
命令 行 输出 。 


等 宽 粗 体 
显示 命令 或 者 其 他 应 该 由 用 户 输入 的 文本 。 


等 宽 和 斜体 
显示 应 该 由 用 户 提供 的 内 容 蔡 换 的 文本 。 
“2. 这 个 图 标 表示 提示 、 建 议 或 者 一 般 的 记录 。 


= 这 个 图 标 表示 一 个 警告 或 者 提醒 . 


使 用 代码 示例 


本 书 有 助 于 你 完成 工作 。 一 般 来 说 ， 可 以 在 程序 或 者 文档 中 使 用 本 书 的 代码 。 关 于 
权限 的 问题 你 并 不 需要 联系 我 们 ， 除非 大 量 复制 代码 。 比 如 , 使 用 本 书 中 的 几 段 代 
码 编写 一 段 程序 并 不 需要 我 们 的 允许 ， 但 是 如 果 使 用 O Reilly 书 中 的 代码 买卖 或 
者 制 成 CD， 则 需要 我 们 允许 才 可 以 。 将 本 书 中 的 大 量 代码 作为 你 的 产品 文档 也 需 
要 权限 。 


我 们 非常 感激 你 在 引用 时 标明 出 处 , 但 是 并 不 强制 。 引用 包括 标题 、 作 者 、 出 版 商 、 
ISBN。 比 如 : “Learning Node by Shelley Powers (O’Reilly). Copyright 2012 Shelley 
Powers, 978-1-449-32307-3” . 





如 果 你 沉 得 你 的 使 用 不 在 上 述 范 围 之 内 ， 请 联系 我 们 permissions@oreilly.com, 


Safari Bookd Online 
Safari Books Online (www.safaribooksonline.com) 是 一 个 即时 的 电子 图 书馆 ， 传 递 
全 世界 在 技术 和 商业 领域 著名 作者 的 书籍 和 视频 。 


技术 专家 、 软 件 开发 人 员 、 网 站 设计 、 商 业 和 创意 专家 都 使 用 Safari Books Online 
作为 他 们 搜索 、 解 决 问题 ， 学 习 和 培训 的 主要 资源 。 


Safari Books Online 为 组 织 、 政 府 代理 和 个 人 提供 了 不 同 的 产品 搭配 组 合 和 定价 。 

购买 者 可 以 访问 数 以 千 计 的 书籍 、 培 训 视 频 , 以 及 从 出 版 商 的 数据 库 访问 还 未 发 布 
的 手稿 ， 比 如 O’ Reilly Media, Prentice Hall Professional, Addison-Wesley 
Professional, MicrosoftPress, Sams, Que, Peachpit Press, Focal Press, Cisco Press, 
John Wiley & Sons, Syngress, Morgan Kaufmann, IBM Redbooks, Packt, Adobe Press, 


FT Press, Apress, Manning, New Riders, McGraw-Hill, Jones & Bartlett, Course 
Technology， 等 等 。 更 多 信息 请 访问 我 们 的 网 站 。 


联系 我 们 
有 关 本 书 的 提问 和 评价 请 联系 出 版 商 : 
O’Reilly Media, Inc. 
1005 Gravenstein Highway North 
Sebastopol, CA 95472 
中 国 : 
北京 市 西城 区 西直门 南大 街 2 号 成 饮 大 厦 C 座 807 室 (100035) 
奥 莱 利 技术 咨询 (北京 ) 有 限 公 司 


我 们 为 本 书 提供 了 网 页 列 出 勘误 表 、 示 例 ， 以 及 其 他 附加 信息 。 可 以 访问 : 
http://oreil.ly/Learning node, 


关于 本 书 的 评价 或 者 任何 技术 问题 ， 请 发 送 邮 件 到 bookquestions@oreily.com, 
更 多 有 关 书 籍 、 课 程 、 会 议和 最 新 信息 , 请 访问 我 们 的 网 站 : http:/www.oreily.com 。 
Facebook: http://facebook.com/oreilly 
Twitter: http://twitter.com/oreillymedia 
YouTube: _ http://www.youtube.com/oreillymedia 
感谢 
感谢 所 有 的 朋友 和 家 人 在 我 写 书 的 时 候 帮 助 我 保持 清醒 。 特 别 感谢 我 的 编辑 Simon 
St. Laurent, ARS UTE A AEE 


还 要 感谢 整个 产品 组 帮助 这 本 书 从 一 个 想法 变 成 一 个 实物 : Rachel Steely, Rachel 


Monaghan, Kiel Van Horn, Aaron Hazelton 和 Rebecca Demarest, 


当 你 使 用 Node 时 ， 你 会 接收 很 多 的 帮助 来 自 于 Node.js 创始 人 Ryan Dahl, npm £ 
造 者 Issac Schlueter， 也 是 现在 的 Node.js 掌 门 人 。 


其 他 为 本 书 提供 了 有 用 的 代码 和 模块 的 是 : Bert Belder, TJ Holowaychuk, Jeremy 


Ashkenas, Mikeal Rogers, Guillerno Rauch, Jared Hanson, Felix Geisendörfer, Steve 
Sanderson, Matt Ranney, Caolan McMahon, Remy Sharp, Chris O° Hara, Mariano 
Iglesias, Marco Aurelio, Damian Suarez, Jeremy Ashkenas, Nathan Rajlich, Christian 
Amor Kvalheim 和 Gianni Chiappetta, QR FE date iA BEB BIRT A A, 
我 在 此 表示 歉意 。 


如 果 没 有 那些 好 心 人 提供 教程 、 做 法 以 及 有 用 的 指导 ， 本 书 还 有 些 什 么 呢 ? 感谢 
Tim Caswell, Felix Geisendorfer, Mikato Takada, Geo Paul, Manuel Kiessling, Scott 
Hanselman, Peter Krumins, Tom Hughes-Croucher, Ben Nadel, VAX Nodejistu 和 


Joyent 的 全 体 人 员 。 


第 1 章 
1.1 


1.2 


1.3 


1.4 
第 2 章 
> 
2.2 
2.3 


2.4 
第 3 章 
3.1 


3.2 
3.3 





Node.js: JBJS CS be ee 1 
搭建 Node 开 发 环境 a E E E E E A E 2 
1.1.1 Linux (Ubuntu ) 下 安装 Node O TE E E A EAT p 
1.1.2 Windows 7 平台 下 Node+WebMatrix…ee 4 
1.1.3 升级 Node ee 8 
开始 Node FF 发 E LAP EA T T E E E T E A A 9 
1.2.1 Hello, World in Node ee 9 
1.23 分 析 “Hello, World”? ee 11 
异步 函数 及 Node 事件 循环 …………………… 13 
1.3.1 使 用 异步 方式 读 取 文 件 i 14 
132 观察 异步 程序 流程 ssn mei orb nora rrr 15 
Node 的 优势 ER RR TT E E O E A T PO OT OR OPT 19 
Node 与 REPL PS POTTS sko eet Weare esce TU TT dete 20 
REPL: 先睹为快 和 未 定义 的 表达 式 OTT TT re E 20 
REPL 的 优势 : 更 好 地 理解 表层 之 下 的 JavaScript eee 22 
多 行 以 及 更 复杂 的 JavaScript i A T T 23 
7.3.1 REPL 命令 人 26 
2.3.2 REPL 和 TlWrap a7 
2.3.3 定制 REPL ee 28 
=e a OS Oe] Tae Ce a 32 
Node 核心 库 和 33 
全 局 对 象 : global, process 和 Buffer ppp 34 
3.1.1 global ee 34 
3.1.2 process 和 36 
3.1.3 Buffep .ee 38 
定时 器 : setTimeout, clearTimeout, setInterval 和 clearInterval …………… 39 
Servers, Streams 和 SocKetS 40 
3.3.1 TCP Sockets 和 Servers en 4] 
3.3.2 HTTP 0 43 
333 UDP 数据 报 套 接 字 DD P E I a ease eR ceRMe risus eoaneanss 45 


3.4 


3.5 
3.6 
3.7 

第 4 章 
4.1 
4.2 
4.3 


4.4 


3.3.4 流 、 管 道 和 Readline .PP 47 
子 进程 怕 0 49 
3.4.1 child process.spawn nn 50 
3.4.2 child _process.exec 和 child _process.execFile ee 52 
3.4.3 child process.forkK ee 52 
3.4.4 FE Windows 系统 中 使 用 子 进程 和 53 
域名 解析 和 URL 处 理 ceceecceceeeeceeceeeeeesesessseseeseeeeeeeeeeeeeeseseeneeseeseseeeseeeeeeeneeesens S4 
Utilities PEER AI KT FAK TR vrrreeeeeeeceeeeetteteeteeeeeeeeeeeeeeseneneseeeeeessssneeeeeeeeeeeeeeeeeees 55 
Events 和 EventEmitter ee 59 
Node 模块 系统 PP 63 
使 用 require 和 默认 路 径 加 载 模 据 ee 63 
外 部 模块 和 Node 包 管 理工 具 和 65 
加 何 找 到 你 需要 的 模块 oneness eeenvonceseneccsececeencecnsstenensnenencssnensasasesssntssesscnssseneses 69 
4.3.1 Colors: 简单 至 上 人 71 
4.3.2 Optimist: 4 一 个 简单 的 小 模块 73 
ry: TT 74 
alae S e nind 75 
4.4.1 打包 整个 目录 ee 76 
4.4.2 ”为 你 的 模块 发 布 做 准备 16 
4.4.3 ”发 布 模块 80 
控制 流 、 异 步 模 式 和 异常 处 理 ………… 82 
使 用 Callback 而 不 使 用 PLOMISES eee. 82 
顺序 调用 、 共 套 回调 、 异 常 捕获 85 
异步 模式 和 控制 流 模 块 a ee 92 
S.3.1 Step ee 93 
5.3.2 ASYIe rrersrsesesesereesestststsetseeeseseaeseneneneneeneneenenenetasasetenetesesnssenteenenenenenenes 96 
Node 编码 风格 和 101 
路 由 寻 址 、 服务 文件 和 中 间 件 PO E Ae 103 
从 头 开 始 : 创建 一 个 简单 的 静态 文件 服务 器 …………………………… 103 
中 fa] 44 RN 110 
6.2.1 Connect 基本 知识 和 111 
6.2.2 Connect 中 间 件 ee 113 
6.2.3 定制 Connect 中 间 件 avin Sea deR peed sdecevacesebeedenseccccsectesiebsenevelesssesessenecusceueees 118 
ROUtErS Se 121 
Proxies -ss sts. 124 


目录 


第 7 = Express 框架 a en 128 
7.1 Express: 启动 和 运行 a i a i 129 
app.js 文件 Od cin enessecbiany teuaweesvuaws 130 
7.3 错误 处 理 ae at A bes kage ene TAA A A euRID 133 
74 Express 与 Connect 的 关系 Ny 134 
7.5 路 由 A a a 135 

7.5.1 路 由 路 笃 e 137 
7.5.2 ”路 由 和 HTTP 动词 ee 140 
7.6 关于 MVC ee 147 
37 使 用 cURL 测试 Express 应 用 程序 人 152 

第 8 章 Express, 模板 系统 和 CS 154 

8.1 EJS 模板 系统 (Embedded JavaScript Template System) ee 154 
81.1 基本 语法 和 155 
81.2 Node 5 EJS ee 156 
8.1.3 EJS 4 Node FjlterS 158 

82 在 Express 中 使 用 EJS ee 159 
82 1 多 对 得 环境 的 改造 naresoononsssdasnosiiino rrr dsr br rasta tr ara 161 
8.2.2 ”静态 文件 路 由 ee 162 
8.2.3 ”处理 一 个 新 对 HAY Post TAK A 164 
8.2.4 Widget 索 引 和 生成 picklist EV en 166 
825 BREA BHAA BAIR PE P ne i 168 
826 提供 更 新 信 已 的 表达 以 及 处 理 PUT 请 来 TR 170 

83 Jade 模板 系统 SR a en tpess0ies (eeseuuseusisensdeavewedeness oessetrenens 173 
83.1 Jade 语法 简介 pion ann en nn en Gbsvlineeusssepieepecsspacnasesnehaatessess 173 
8.3.2 使 用 block 和 extends 模块 化 视图 模板 P ee E covenants 176 
833 Widget View 转换 为 Jade 模板 a 178 
8.3.4 转换 edit 和 delete 表单 人 179 

8.4 使 用 Stylus 完成 简单 的 CSS 样式 站 182 

第 9 章 ”结构 化 数据 、Noe 和 REGIS ee 187 
9.1 Node 利 Reig ee 188 
92 构建 游戏 得 分 排行 榜 A 190 
93 创建 消息 队列 TO OO 197 
94 为 Express 应 用 程序 添加 统计 中 间 件 ea nd end 201 

第 10 章 Node 和 MongoDB: 文档 中 心 数据 ee 206 
10.1 MongoDB Native Node.js Driver (MongoDB 原生 Node.js 驱动 ) … 207 


目录 3 


10. l . l MongoDB N 门 cc EEA E cue webes sees G0 o cece PO TT EE co eeecesceeveetecseseae 207 


10.1.2 定义 、 创 建 以 及 销毁 MongoDB Collection trte 208 
10.1.3 Æ Collection 添加 数据 PP 209 
10.1.4 ”查询 数据 nn 712 
10.1.5 使 用 Updates. Upserts. Find 和 Remove ppp 216 

10.2 ”使 用 Mongoose 实现 Widget 模块 .0 721 
10.3 重 构 Widget a ie ee ne pp, 
10.4 添加 MongoDB ES AONE RINE A EE E A EA PEAB OL ret RE 333 
第 11 章 Node 与 关系 型 数据 库 PP 228 
11.1 db-mysql 入门 ee 229 
11.1.1 查询 字符 串 和 方法 链 eeeeererrerrerrererereerrenrerreererrerneensrereneeeeereeerenes 229 
11.1.2 使 用 查询 字符 串 更 新 数据 库 a A E NE ET. 933 
Lia Sob =: 22 oe). mene vt orem rer ers ee 235 
11.2 ”使 用 node-mysql 实现 本 地 MySQL YPJ -eceereceeeseeeeeeeeeeteeeteeeeeseeeneseees N39 
11.2.1 使 用 node-mysql 做 基本 的 CRUD 操作 ppp 537 
11.2.2 MySQL 4 44 mysql-queues ee 239 

11.3 ORM E Sequelize a de AEA ee EETA 241 
11.3.1 定义 模型 a 避 放 训 和 二 二 记 人 和 241 
11.3.2 ORM 风格 的 CRUD 实现 RR OPO WO OC RN TO IE 943 
11.3.3 添加 多 个 对 得 vrrrereeeeeeeeseceeseeeeesseeenssseeensseeesseeeensneeessseeeesseeesesseeeeeeeees 246 
11.3.4 从 关系 型 到 ORM ee 247 

第 12 章 图 形 和 HTML5 Vigdeg .PP 248 
12.1 创建 和 使 用 PDF .PP 248 
12.1.1 使 用 子 进程 访 问 PDF 工具 :ee 249 
12.1.2 使 用 PDFKit 创建 PDE .PP 257 

12.2 ”从 子 进程 访问 ImageMagick ee 258 
12.3 M$ HTTP 提供 HTMLS Video 服务 eeeeereeereeeerrerrsrrerererrerereersneereeeersees 263 
12.4 创建 和 流 化 画布 内 容 (Canvas Content) pp 267 
第 13 & WebSockets 和 Socket. |O -eeeeerererererereerrerrertersrrerrsresersresrsnrennsnreresees 971 
13.1 WebSocKetgS pp 271 
13.2 Socket.IO 简介 ORERE AE T E a E EAA 379 
13.2.1 一 个 简单 的 通信 范例 和 a 7a 
13.2.2 异步 世界 里 的 WebSockets pp 276 
13.2.3 ”关于 客户 端 代 码 ee O77 

13.3 配置 Socket IO .pp 278 


4 AXK 


13.4 Chat: WebSockets 版 本 的 “Hello, World” TAAT EAS ENE E O A 279 


13.5 在 Express 中 使 用 Socket. 10 eererrerreerteererreereeeresrseerersessreersenssernesssenseenees 282 
第 14 音 Node 应 用 程序 的 测试 和 调试 …………………… 284 
14.1 JAJA eee eee 284 
14.1.1 Node.js Debugger™ 284 
14.1.2 使 用 Node Inspector AJR ae ee ee 287 

14.2 ”单元 测试 (Unit Testing) PE E A EE A E OO 289 
14.2.1 Assert 5 2 0) bc 289 
14.2.2 Nodeunit 与 单元 测试 ee 293 
14.2.3 ”其 他 测试 框架 295 

14.3 验收 测试 a E O A T T 299 
14.3.1 Soda 和 Selenium 测试 299 
14.3.2 通过 Tobi 和 Zombie 模拟 浏览 器 ee 303 

14.4 ”性 能 测试 : 基准 问题 和 负载 测试 304 
14.4.1 ApacheBench 基准 测试 en 305 
14.4.2 Nodeload 与 负载 测试 cecccceeeeeeeteeeeeeeeteeeeeeeteeeeeeeeeeeeeeeeeeeeesteneeeeetanes 309 

14.5 Nodemon 更 新 代码 …… 312 
第 15 章 ”安全 及 防护 ……… 人 nn 313 
15.1 AREA T IERE T been E E E A R EAEE S EN ee 314 
15.1.1 TSL/SSL 配置 ee 314 
15.1.2 使 用 FIT TPS .pe 315 
15.1.3 hole] 2A YY TRAE SE AB, spheednvaewhevensesbuensbsadsnensonsoenensen OR 317 

15.2 ”认证 /授权 及 Passport --esrsrscseesessescesesseseeeeeeeseeneeneeneensenennennecneeneensensennsens 320 
15.2.1 授权 /认证 策略 : Oauth. OpenID. A P 4/33 AGRE 321 
15.2.2 Local Passport Strategy ee 323 
15.2.3 Twitter Passport Strategy ( OAuth ) ee 330 

15.3 ”保护 应 用 程序 ， 防 止 攻击 336 
15.3.1 不 要 使 用 eval pe 336 
15.3.2 KAARI, iiiaj FIANE ereere 337 
15.3.3 ”使 用 node-validatop PP 337 

15.4 在 沙 箱 中 执行 代码 oooeeooeocoeoooooooooscoooooooooooooooooooooooeoooooooooesoooooooooooeosooeseooeoo。 339 
第 16 章 扩展 和 部 署 Node jA eeeeereeererrrrerererrrereresrerersserernnenensnenenerenerenenennnes 343 
16.1 把 你 的 节点 部 署 到 服务 器 上 coeeeeeeeeeeseeeseeee tees eeeeteeeneesneseeeneseeeeeneneeneeeeens 343 
16.1.1 编写 package.json 文件 aaaeeeaa 344 
16.1.2 使 用 Forever 让 你 的 应 用 “ 永 不 掉 线 虽 .ee 347 


目录 5 


16.1.3 使 用 Node 和 Apache ee 350 

16.1.4 r EE 352 

16.2 ”部 署 到 云 服务 和 352 
16.2.1 通过 Cloud9 IDE 部 署 到 Windows Azure pp 353 

16.2.2 Joyent Development SmartMachine ee 355 
全 355 
| 356 

16.2.5 Nodejits 356 

附录 Node, Git 和 和 GitHub 357 


6 目录 


第 1 
Node.js: 局 动 与 运 


2N a 


Node.js 是 以 Google V8 JavaScript 3| HARE AmA CRAIR KAA 
展 性 ， 并 使 用 了 异步 事件 驱动 IO ， 而 没有 使 用 线程 或 者 独立 进程 。 它 能 很 好 地 满 
足 那 些 需 要 频 索 访问 但 是 计算 简单 的 网 络 应 用 的 需求 。 


使 用 传统 的 Web 服务 器 时 ， 比 如 Apache， 每 次 接收 到 用 户 对 网 络 资源 的 请 求 时 ， 
Apache 都 会 创建 一 个 线程 或 者 调用 新 的 进程 来 处 理 。 尽管 Apache 对 请 求 的 响应 速 
度 非常 快 ， 并 在 请 求 处 理 完毕 后 清理 现场 ， 但 这 种 实现 仍然 占用 了 很 多 资源 。 访问 
频繁 的 网 络 应 用 会 因此 产生 严重 的 性 能 问题 。 


相 较 而 言 ，Node 不 会 为 每 个 请 求 创建 新 的 进程 或 者 线程 。 相 反 ， 它 对 特定 事件 进 
行 监听 ， 当 事件 发 生 时 按 需 做 出 啊 应 。 在 等 待 事件 的 过 程 中 Node 并 不 阻止 任何 请 
求 ， 并 且 事 件 循环 是 按照 先 到 先 得 的 简单 方式 进行 处 理 。 


与 编写 客户 端 应 用 程序 所 使 用 的 语言 一 样 ,Node 应 用 程序 也 是 用 JaveScript 编写 的 
(或 者 其 他 可 以 编译 成 JaveScript 的 语言 )。 不 过 与 前 者 不 同 的 是 ， 做 Node 应 用 程 
序 开 发 前 ， 首 先 需要 搭建 开发 环境 。 

Node 支持 Unix/Linux, MaxOS 以 及 Windows 等 多 种 操作 系统 。 本 章 会 告诉 
你 在 安装 Node 之 前 需要 完成 的 准备 工作 ， 并 带领 你 学 习 如 何在 Windows7 和 
Linux ( Ubuntu) 系统 上 搭建 Node 开发 环境 。Mac 系统 的 安装 过 程 与 Linux 
类 似 。 

当 搭建 好 开发 环境 后 ， 我 们 会 通过 一 个 简单 的 Node 示例 应 用 ， 来 说 明 Node 中 最 
重要 的 事件 循环 机 制 。 


1.1 搭建 Node 开发 环境 


安装 Node 有 多 种 方法 。 选 择 什么 样 的 方法 取决 于 你 当前 使 用 的 开发 环境 ， 以 及 你 
希望 如 何 使 用 源 代码 或 者 计划 如 何在 你 现 有 的 应 用 程序 中 使 用 Node。 


Windows 和 Mac OS 都 有 相应 的 安装 包 ， 但 是 你 也 可 以 复制 Node 源 代码 并 自行 编 
译 安装 。 在 Windows, Linux 和 Mac OS 环境 中 ,你 也 可 以 使 用 Git 的 clone 命令 来 
复制 Node 的 repo (repository ， 代 码 库 )。 


本 市 演示 如 何在 Linux 系统 中 (Ubuntu 10.04 VPS， 或 者 虚拟 服务 器 ) 通过 编译 源 
码 搭建 Node 环境 ， 同 时 也 会 演示 如 何在 Windosw7 系统 上 安装 Node， 以 便 配 合 
Microsoft WebMatrix 使 用 。 
nee 提示 
可 以 从 这 个 地 址 下 载 Node 源 代码 及 安装 包 :http:/no dejs.org/#download. 
人 Wiki 关于 多 种 环境 中 安装 Node 的 说 明 : https://github.com/joyent/node/ 
iki/Installing-Node-via-package-manager. &- Node 不 时 会 有 版 本 更 
新 ， 建 议 读者 自己 搜索 最 新 的 关于 特定 环境 下 安装 Node 的 教程 。 


1.1.1 Linux (Ubuntu) 下 安装 Node 

在 Linux 下 安装 Node 之 前 ， 你 需要 先 做 一 些 准 备 工 作 。 按 照 Wiki Node 词 条 
中 提 到 的 步骤 首先 要 确认 是 否 安装 Python ， 如 果 计 划 使 用 SSL/TLS ( Secure 
Sockets Layer， 安 全 套 接 层 /Transport Layer Security ， 传 输 层 安全 ) 还 需要 安装 
libssl-dev。 某 些 Linux 系统 中 默认 安装 了 Python。 如 果 没 有 ,， 则 可 以 使 用 系统 
包 安 装 工具 安装 Python 的 稳定 版 本 , 如 2.6 或 者 2.7( Node 最 新 版 本 所 要 求 的 
Python 版 本 号 )。 


a 提示 
本 书 假 定 你 有 JavaScript 和 传统 Web 开发 的 经 验 。 如果 这 样 的 话 , 我 可 
能 是 过 于 谨慎 了 ， 并 且 在 档 述 如 何 安装 Node 的 前 期 准备 上 太 哆 唆 了 . 
对 Ubuntu 和 Debian 来 说 还 需要 安装 其 他 的 库 。 大 部 分 Debian GNU/Linux 系统 中 


都 支持 APT ( Advanced Packaging Tool) 工具 ， 你 可 以 用 以 下 apt 命令 来 确认 是 否 
已 安装 了 需要 的 库 : 
sudo apt-get update 


sudo apt-get upgrade 
sudo apt-get install build-essential openssl libssl-dev pkg-config 
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update 命令 用 于 确认 系统 上 的 包 都 更 新 了 ，upgrade 命令 用 于 升级 过 期 的 包 。 第 三 
条 命令 用 于 安装 需要 的 包 。 任 何 包 依 赖 都 由 包 管 理工 具 管 理 。 


当 准 备 好 环境 后 ， 下 载 Node tarball ( 源 代 码 的 压缩 文件 )。 本 书 使 用 wget， 你 也 可 
以 使 用 curl。 在 编写 本 书 的 时 候 Node 的 最 新 版 本 是 0.8.2: 


wget http://nodejs.org/dist/v0.8.2/node-v0.8.2.tar.gz 


下 载 完 成 后 ? 解压 : 
tar -zxf node-v0.8.2.tar.gz 
得 到 目录 node-v0.6.18。 进 入 该 目录 ,使 用 以 下 命令 编译 安装 Node: 


./configure 
make 
sudo make install 


考虑 到 某 些 读者 之 前 没 在 Unix 中 使 用 过 make 命令 ， 同 此 ， 对 这 三 条 命令 简单 说 
明 一 下 : 第 一 条 命令 首先 进行 依赖 检查 ， 然 后 根据 你 的 系统 环境 和 安装 情况 建立 
makefile， 然 后 执行 make 命令 编译 最 后 一 条 命令 执行 安装 操作 。 在 这 些 命令 执行 
后 ，Node 即 安装 完毕 并 可 以 通过 命令 行 全 局 访问 。 


wA, 提示 
编程 的 挑战 在 于 没有 两 个 系统 是 一 样 的 。 在 大 部 分 Linux 环境 下 这 一 
SS 系列 安装 步骤 应 该 是 能 工作 且 可 以 成 功 的 。 但是， 关键 词 是 “应 该 ”。 


是 否 注 意 到 最 后 一 条 命令 的 sudo? 这 是 为 了 以 root 权限 在 Linux PR Node. Hit, 
你 还 可 以 用 以 下 命令 在 指定 的 下 级 目录 中 安装 Node: 

mkdir ~ /working 

./configure --prefix=~ /working 

make 

make install 

echo ‘export PATH=~ /working/bin:${PATH}' >> ~/.bashrc 

. ~/.bashre 
可 以 看 到 ， 通 过 设置 prefix 配置 选项 ， 你 可 以 将 Node 安装 到 本 地 指定 路 径 的 目录 
中 。 另 外 别 忘 记 你 可 能 还 需要 相应 地 为 PATH 环境 变量 做 些 更 新 。 


提示 
如 果 使 用 sudo， 你 需要 root 或 者 超级 用 户 的 权限 。 此 时 你 的 用 户 名 儿 
须 存在 于 /ect/sudoers 文件 的 列表 中 。 





SET WORE Node 安装 到 本 地 路 径 , 但 是 如 果 考 虑 到 我 们 所 有 的 安装 步 又 部 是 在 一 个 共享 
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的 主机 环境 下 进行 的 ， 是 否 能 采用 这 种 安装 方式 还 需 三 思 。 因 为 安装 Node 只 是 第 一 步 ， 
接 下 来 你 还 需要 权限 来 编译 Node 应 用 程序 ,需要 权限 来 让 程序 运行 在 特定 端口 ( 比如 80 )。 
事实 上 绝 大 多 数 共享 主机 环境 并 不 会 允许 我 们 在 本 地 路 径 下 随意 安装 特定 版 本 的 Node. 


除非 有 特殊 原因 ， 依 然 推 荐 使 用 sudo 安装 Node。 


提示 
在 本 书 第 4 章 我 们 会 提 到 , 使 用 root 权限 运行 Node 包 管 理工 具 ( npm ) 
曾经 存在 的 一 个 安全 顾虑 。 但 是 ， 目 前 这 些 安全 问题 已 经 解决 。 





1.1.2 Windows 7 平台 下 Node+WebMatrix 


你 可 以 按照 之 前 wiki 页 面 中 的 安装 步骤 完成 Windows 系统 下 Node 的 安装 。 但 一 
般 来 说 ，Node 只 是 作为 Windows Web 开发 架构 的 一 部 分 。 


目前 有 两 种 Windows Web 开发 染 构 适合 使 用 Node。 一 种 叫做 Windows Azure 云 平 
台 ， 人 允许 开发 人 员 将 程序 托管 在 远 端 服务 器 〈 称 为 云 ) 上 。Microsoft 提供 了 关于 
如 何在 Windows Azure SDK 中 安装 Node 的 说 明 ， 所 以 本 章 不 涉及 这 一 过 程 (不 过 
稍 后 会 对 该 SDK 进行 说 明 )。 

提示 

Windows Azure SDK for Node 安装 说 明 : https://www.windowsazure.com/ 
en-us/develop/nodejs/. 





另 一 种 在 Windows 系统 ( 本 处 指 Windows 7 ) 使 用 Node 的 方式 是 将 Node 5 Microsoft 
WebMatrix 集成 。WebMatrix 是 网 络 开 发 人 员 用 于 集成 开源 技术 的 一 种 工具 。 以 下 
是 在 Windows 7 WebMatrix 中 集成 并 运行 Node 的 步骤 . 


1， 安 装 WebMatrix; 
2. 使 用 最 新 的 Windows 安装 包 安 装 Node; 


3. 安装 iisnode for IIS Express 7.x， 以 便 让 Windows 上 的 IIS 支持 Node 应 用 
程序 ; 


4. 为 WebMatrix 安装 Node 模板 ， 使 用 模板 可 以 简化 Node 开发 。 


如 图 1-1 所 示 ， 使 用 Microsoft Web Platform Installer 安装 WebMatrix， 同 时 会 安装 
IIS Express. IIS Express 是 Microsoft Web 服务 硕 的 开发 版 本 。 


WebMatrix 的 下 载 地 址 : http://www.microsoft.com/Web/Webmatrix/. 
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1-1 在 Windows 7 中 安装 WebMatrix 

WebMatrix 安装 完成 后 ， 可 以 使 用 Node 官网 ( http://nodejs.org/#download ) 提供 的 
安装 包 安 装 最 新 版 本 的 Node。 过 程 很 简单 ， 一 键 安 疫 完成 后 打开 命令 行 窗 口 输入 
node 检查 是 否 能 正常 运行 ， 如 图 1-2 所 示 。 

为 了 能 让 Node 与 Windows 下 的 IS 一 起 工作 ， 我 们 需要 安装 iisnode。iisnode 是 一 个 本 
地 TIS7.x 模块 ， 由 Tomasz Janczuk 创建 并 维护 。 它 在 Git Hub 站 点 中 的 链接 地 址 为 : 
https://github.com/tjanczuk/iisnode, 


iisnode 有 x86 和 x64 两 种 ， 但 是 对 于 x64 系统 ， 两 个 都 需要 安装 。 








fi Command Prompt 





1-2 在 Windows 命令 窗口 中 测试 Node 是 否 被 正确 安装 








在 安 疫 iisnode 的 过 程 中 ， 可 能 会 碰 到 图 1-3 所 示 的 弹出 窗口 ， 提 示 系 统 环境 
中 未 安装 Microsoft Visual C++ 2010 Redistributable Package。 如 果 你 碰 到 了 这 
种 情况 ， 则 需要 安装 该 组 件 , 同时 还 需要 保证 你 安装 的 版 本 与 当前 正在 安装 的 
iisnode 的 版 本 是 兼容 的 : 可 以 从 x86 版 本 ( 从 地 址 http://www.microsoft.com/ 
download/en/details. aspx?id=5555 获得 ) BK x64 版 本 (从 地 址 http://www .microsoft. 
com/download/en/details. spx?id=14632 获得 ) 中 选择 安装 ,或 者 两 个 版 本 都 安装 。 
在 成 功 安 装 好 C++ Redistributable Package 后 ， 就 可 以 再 次 运行 iisnode 安装 程 
FFT « 





express 7x Setup 





Microsoft Visual C++ 2010 Redistributable Package 
> (x85) is required but not installed. Please install it then 
= rerun this installer. 





1-3 ”提示 对 话 框 : 需要 安装 C++ redistributable package 


如 果 你 还 想 安 装 iisnode 的 附带 的 示例 代码 ， 则 需要 以 管理 员 权 限 打开 命令 窗口 ， 
进入 到 iisnode 的 安装 日 录 中 (“Program Files for 64- bit ”或 者 “Program Files (x86)”) 
然后 运行 名 为 setupsamples.bat 的 批 处 理 文件 。 


最 后 还 需要 为 WebMatrix 下 载 并 安装 Node 模板 ， 这 样 就 完成 了 WebMatrix/Node 
的 所 有 安装 。Node 模板 由 Steve Serson 创建 ,可 以 在 地 址 https://github.com/SteveSan 
derson/Node-Site-Templates-for-WebMatrix 下 载 。 


你 可 以 通过 如 下 步骤 来 测试 以 上 工作 的 正确 性 ， 首 先 运行 WebMatrix， 在 打开 
页 面 中 选择 “Site from Template” 选 项 。 然 后 ， 图 1-4 所 示 页 面 会 打开 ， 你 可 
以 看 到 两 个 Node 模板 选项 : 一 个 是 “Express”( 在 第 7 章 介 绍 ), 男 一 个 是 “a 
basic, empty site configured for Node”。 选 择 后 者 ， 并 使 用 “First Node Site” 或 
者 一 个 你 喜欢 的 名 称 为 新 建 的 站 点 命名 。 


使 用 WebMatrix 生成 的 新 站 点 如 图 1-5 所 示 。 点 击 页 面 左 上 角 的 Run 按钮 , 浏览 器 
窗口 会 弹出 并 显示 包含 有 “Hello, world!” 信 息 的 页 面 。 


如 果 你 在 使 用 Windows 防火 墙 , 第 一 次 运行 一 个 Node 应 用 程序 时 , 你 可 能 会 得 到 
一 个 如 图 1-6 所 示 的 警告 信息 。 这 时 ， 你 需要 点 击 “Private networks” 选 项 然后 按 
F “Allow access” 按 钮 ， 以 便 让 防火 墙 知 道 该 程序 是 被 允许 在 开发 机 天 的 私有 网 


络 上 通信 的 。 


Quick Start - Microsoft WebMatrix 


Site from Template 


Templates (7) 


Starter Site Photo Gallery 


Node.js Express... Empty Node.js Si... 
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1-5 使 用 WebMatrix 新 生成 的 Node 站 点 
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1-6 Windows 防火 墙 拦截 Node 应 用 程序 时 的 警告 信息 ， 以 及 允许 访问 所 需 义 选 项 
在 新 生成 的 WebMatrix Node 工程 中 ， 存 在 一 个 名 为 app.js 的 文件 。 这 是 一 个 Node 
程序 文件 ， 包 含 了 如 下 代码 : 


var http = require('http'); 

http.createServer(function (req, res) { 
res.writeHead(200, { 'Content-Type': 'text/html' }); 
res.end('Hello, world!'); 

}).listen(process.env.PORT || 8080); 


我 会 在 本 章 第 二 部 分 对 这 段 代码 的 相关 部 分 进行 详细 介绍 。 目 前 , 我 们 只 需要 知道 
这 段 代 码 实 现 了 一 个 简单 的 服务 端 ， 它 只 给 客户 端 返回 “Hello, world!”。 而 且 我 们 
可 以 在 任何 安装 有 Node 环境 的 系统 中 运行 这 段 代 码 ， 并 且 能 得 到 同样 的 功能 。 
提示 

车 需要 在 WebMatrix 中 查看 iisnode 的 示例 ， 则 需要 在 WebMatrix 中 
选择 选项 “Site from Folder”， 然 后 在 弹出 的 对 话 框 中 输入 如 下 内 容 : 


%localappdata%\iisnode\www. 











1.1.3. 升级 Node 


偶数 版 本 号 代表 了 Node 的 稳定 发 行 版 本 ， 例 如 当前 的 0.8.x 版 本 ， 而 奇数 版 本 号 
表示 Node 的 开发 版 本 ( 当前 是 0.9.x )。 在 你 有 一 些 Node 使 用 经 验 前 , 我 建议 选择 
稳定 发 行 版 本 。 


升级 Node 版 本 并 不 复杂 。 如 果 你 使 用 安装 包 来 做 升级 ， 郁 么 旧版 本 的 Node 将 日 
动 被 新 版 本 覆盖 。 如 果 你 直接 使 用 源 代 码 升 级 ,为 了 避免 潜在 的 混乱 或 者 文件 冲突 ， 
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你 始终 应 该 先 在 旧版 源 代 码 目录 中 执行 印 载 命 令 ， 然 后 再 安装 新 版 本 。 在 Node W 
代码 目录 中 ， 可 以 运行 如 下 make 命令 执行 和 印 载 : 

make uninstall 
下 载 新 的 源 代码 , 编译 然后 安装 它 。 当 再 有 版 本 更 新 时 , 你 需要 再 次 执行 以 上 过 程 。 


升级 Node 的 挑战 在 于 ,新 版 本 的 Node 是 否 还 能 兼容 特定 的 环境 、 模 块 或 者 Node 
应 用 程序 。 大 多 数 情 况 下 ， 你 不 会 碰 到 版 本 问题 。 然 而 ， 如 果 你 碰 到 了 ， 你 可 以 使 
用 Node 版 本 管理 器 (Nvm, Node Version Manager ) 在 多 个 Node 版 本 之 间 切 换 。 


你 可 以 从 GitHub 上 下 载 Nvm， 地 址 是 https://github.com/creationix/nvm. = Node 
一 样 ， 你 必须 在 你 的 系统 中 编译 并 安装 Nvm。 
使 用 Nvm 安装 指定 版 本 的 Node: 
nvm install v0.4.1 
使 用 如 下 命令 切换 到 指定 Node 版 本 : 
nvm run v0.4.1 
查看 可 用 的 Node 版 本 信息 : 


nvm ls 


1.2 ”开始 Node 开发 


现在 你 已 经 安装 了 Node， 是 时 候 开 始 编写 第 一 个 Node 应 用 程序 了 。 


1.2.1 Hello, World in Node 

为 了 测试 新 的 开发 环境 、 语 言 或 者 工具 ,第 一 个 写 出 来 的 程序 往往 是 “Hello,World”。 
我 们 同样 也 将 使 用 Node 创建 一 个 “Hello,World” 程 序 ， 它 仅仅 简单 的 向 访问 它 的 
用 户 输出 问候 语 。 

示例 1-1 包含 了 使 用 Node 创建 Hello,World 程序 需要 的 全 部 文本 代码 。 


示例 1-1 Node 版 Hello, World 


// load http module 
var http = require('http'); 


//{ create http server 
http.createServer(function (req, res) { 


// content header 
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// content header 
res.writeHead(200, {'content-type': ‘text/plain'}); 


// write message and signal communication is complete 
res.end("Hello, World!\n"); 
}). Listen(8124) ; 


console. log( ‘Server running on 8124'); 


代码 被 保存 在 名 为 helloworldjs 的 文件 中 。 作 为 服务 端 开 发 使 用 的 Node， 其 代码 既 
不 宛 长， 也 不 模糊 。 即 使 是 一 个 不 曾 接触 过 Node 的 人 ,也 可 以 直观 地 看 出 代码 所 表 
达 的 意思 。 不 过 可 能 最 吸引 人 的 是 , 它 采 用 了 我 们 很 熟悉 的 JavaScript 语言 编写 程序 。 


可 以 在 Linux 系统 中 使 用 命令 行 ， 或 在 Mac OS 中 使 用 终端 窗口 WE Windows 
中 使 用 命令 窗口 ， 运 行 如 下 命令 来 启动 示例 程序 : 

node helloworld.js 
在 程序 成 功 运行 后 ， 会 输出 如 下 信息 : 

Server running at 8124 
现在 , 你 应 该 可 以 使 用 任何 浏览 器 访问 站 点 了 。 如 果 应 用 程序 是 在 本 地 机 器 上 运行 
的 ， 可 以 使 用 localhost:8124。 如 果 是 在 远程 机 器 上 运行 的 ， 需 要 使 用 远程 机 需 的 
URL 并 访问 8124 端口 。 在 浏览 器 中 ,一 个 显示 有 “Hello,World! ”内容 的 页 面 将 会 
被 显示 出 来 。 到 目前 为 止 ， 你 已 经 成 功 创建 了 第 一 个 完整 的 并 且 可 以 正 篆 工作 的 
Node 应 用 程序 了 。 
警告 
如 果 是 在 Fedora 系统 中 安装 Node 环境 , 需要 留意 Node 会 被 重 命名 ,以 避 
免 与 系统 中 现 有 功能 的 冲突 。 更 多 详细 信息 请 查阅 http://nodejs.tchol.org/。 


由 于 我 们 没有 在 node 命令 后 使 用 & (使 应 用 程序 在 后 台 运 行 )， 在 程序 启动 后 ， 你 就 不 
能 返回 到 命令 行 了 。 不 过 你 依然 可 以 继续 正常 访问 应 用 程序 , 并 且 同 样 的 信息 会 被 显示 
在 浏览 器 窗口 中 ， 直 到 你 使 用 Ctrl+C 来 停止 程序 ， 或 使 用 kill 命令 来 中 止 node 进程 。 


如 果 想 在 后 台 运 行 应 用 程序 ， 在 Linux 系统 中 可 以 使 用 如 下 命令 : 





node helloworld.js & 


之 后 ， 你 需要 通过 “ps-ef” 命 令 找 到 进程 对 应 的 ID ， 然 后 使 用 kill 命令 手动 关闭 
该 进程 ( 比如 进程 ID 为 3747 ) : 


ps -ef | grep node 
kill 3747 
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如 果 你 退出 终端 窗口 node 进程 同样 也 会 中 止 。 


提示 
在 第 16 章 中 ， 我 会 讨论 如 何 创建 一 个 可 持久 的 Node 应 用 程序 安装 。 





你 不 能 启动 另外 一 个 监听 同一 端口 的 Node 应 用 程序 : 因为 在 同一 时 间 、 同 一 端口 
上 ， 只 能 运行 一 个 Node 应 用 程序 。 如 果 你 的 Apache 工作 在 端口 80 上 ， 你 也 不 能 
在 该 端口 上 启动 Node 应 用 程序 。 你 必须 为 每 一 个 应 用 使 用 不 同 的 端口 号 。 


如 果 你 在 使 用 WebMatrix 的 话 , 也 可 以 将 helloworld.js 作为 一 个 新 文件 添加 到 之 前 


生成 的 WebMatrix 站 点 项 目 中 。 你 只 需要 打开 站 点 ， 从 菜单 中 选择 “New File…” 
选项 ， 然 后 将 示例 1-1 中 的 代码 输入 到 创建 的 文件 中 ， 点 击 运 行 按钮 。 


tite He 

下 SA 

-S WebMatrix ZÆ & Node 程 序 中 使 用 的 端口 号 。 当 你 运行 应 用 程序 后 ， 
尔 只 能 通过 项 目 中 定义 好 的 端口 访问 站 点 ， 而 不 能 使 用 在 
http.Server.listen 方法 中 指定 的 端口 。 


1.2.2 分 析 “Hello,World” 
我 会 在 后 续 草 市 对 Node 应 用 程序 进行 更 多 放 析 。 但 是 现在 ， 我 们 先 来 仔细 看 看 
“Hello, World” 程 序 。 
在 示例 1-1 中 ， 第 一 行 代码 是 : 

var http = require('http'); 
Node 中 的 许多 功能 通过 外 部 程序 或 库 来 提供 ， 我 们 叫 它 模 块 (modules )。 这 句 代 
码 其 实 就 是 用 来 加 载 HTTP 模块 ， 然 后 指派 给 一 个 本 地 变量 。HTTP 模块 能 提供 基 
本 的 HTTP 功能 ， 可 以 让 应 用 程序 支持 对 网 络 的 访问 。 
下 一 名 代码 是 : 

http.createServer (function (req, res) { ... 
在 这 行 代 码 中 ， 使 用 了 createServer 方法 创建 了 一 个 新 的 服务 器 ， 并 且 传 递 了 一 个 
匿名 上 果 数 来 作为 该 方法 时 的 参数 。 这 个 匿名 困 数 就 是 requestListener PIAL, CAM 
个 参数 : 一 个 代表 服务 需 收 到 的 请 求 ( http.ServerRequest )， 另 一 个 代表 服务 器 的 响 
应 〈http.ServerResponse )。 


在 匿名 函数 中 ， 有 如 下 代码 


res.writeHead(200, {'content-Type': 'text/plain'}); 
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在 http.ServerResponse 对 象 中 有 一 个 writeHead 方法 ,我 们 用 它 来 发 送 响 应 信息 的 
HTTP k, JHE S HTTP KASH (status code) 为 200， 同 时 还 提供 了 内 容 类 
型 content-type。 你 同样 可 以 通过 headers 对 象 来 设置 其 他 HTTP 响应 头 中 需要 的 
信息 ， 例 如 content-length 或 者 connection: 


{ *‘content-length': '123', 
‘content-type': 'text/plain', 
‘connection': 'keep-alive', 
"accepts: I a/*" +) 


writeHead 的 第 二 个 可 选 参数 是 reasonPhrase， 用 来 对 状态 码 指定 文本 描述 。 

依据 下 面 代码 将 “Hello,World!” 内 容 放 入 响应 信息 中 ， 并 发 送 响 应 : 
res.end("Hello, World!\n"); 

调用 http.ServerResponse.end 方法 表示 本 次 通信 已 经 完成 , 所 有 响应 信息 的 头 和 内 容 均 已 

经 被 发 送 。 注 意 : 你 必须 为 每 一 个 http.SErverResponse 对 象 使 用 该 方法 。 

end 方法 有 两 个 参数 : 

。 ”一 个 数据 块 ， 可 以 是 一 个 字符 串 或 者 buffer 对 象 ; 

。 ”如 果 数 据 块 是 字符 串 对 象 ， 第 二 个 参数 用 于 指定 编 公 方 式 。 

这 两 个 参数 都 是 可 选 的 , 而 且 只 有 在 字符 串 是 非 utf8 编码 的 情况 下 才 需 要 指定 第 

二 个 参数 ， 因 为 其 默认 值 是 utf8。 

我 们 也 可 以 不 在 end 方法 中 传递 数据 块 ， 而 使 用 另 一 个 write 方法 : 
res.write("Hello, World! \n"); 

然后 : 
res.end(); 


FAAR, dean S EA PRA createServer 果 数 的 结束 : 

}) .listen(8124) ; 
http.Server.listen J KİZ createServer 之 后 调用 ， 用 于 在 指定 端口 ( 本 例 中 为 
8124) 监听 接 人 的 客户 端 连 接 。 它 的 可 选 参数 是 一 个 hostname 和 一 个 回调 果 数 。 
如 果 指 定 『 hostname, P mK AE Web 地 址 的 形式 访问 服务 端 了 ， 比 如 
http://oreilly.com 或 者 http://examples.burningbird .net。 


wa 提示 
本 章 后 半 部 分 对 callback 函数 有 更 多 介绍 . 
R 


listen 方法 是 异步 的 ， 这 意味 着 在 应 用 程序 等 待 客户 问 连 接 建立 时 ， 不 会 阻塞 程序 
的 执行 。listen 方法 之 后 的 所 有 代 介 都 会 被 执行 。 而 且 当 连接 建立 起 来 后 ， 一 个 
listening 事件 会 被 触发 ， 传 给 listen 方法 的 回调 晒 数 会 被 执行 。 
最 后 一 句 代 但 是 : 

console.log('Server running on 8124/'); 
console 是 一 个 起 源 于 浏览 器 环境 并 被 Node 采用 的 众多 对 象 之 一 ,大 多 数 JavaScript 
开发 人 员 对 它 都 很 熟悉 。 在 此 处 , 它 提供 了 将 文本 信息 输出 到 命令 行 (或 者 开发 环境 ) 
的 功能 ， 而 不 再 是 输出 信息 到 客户 闹 浏 览 瘟 中 。 


1.3 异步 函数 及 Node 事件 循环 


Node 的 基本 设计 原则 是 将 应 用 程序 放置 在 单线 程 (或 单 进程 ) 中 执行 ， 同 时 异步 
处 理 所 有 事件 。 


考虑 下 典型 的 Web 服务 器 ( 如 Apache ) 是 如 何 工 作 的 。Apache 可 以 采用 两 种 不 同 
的 方式 处 理 传 入 的 请 求 : 一 种 方式 是 将 传人 的 每 个 请 求 分 配 到 独立 的 进程 中 直至 请 
求 被 处 理 完 毕 ; 另 一 种 方式 则 是 为 每 一 个 请 求生 成 单独 的 处 理 线程 。 


第 一 种 方式 (也 称 为 prefork multiprocessing model， 或 prefork MPM ) 可 以 根据 
Apache 配置 文件 中 指定 的 值 创 建 多 个 子 进程 。 使 用 进程 的 优势 在 于 被 请 求 的 应 用 
(如 PHP 应 用 ) 无 需 考 虑 线程 安全 问题 ; 缺点 是 每 个 进程 占用 独立 内 存 ， 内 存 消耗 
大 ， 应 用 的 扩展 性 也 不 是 很 好 。 


第 二 种 方式 (也 称 为 worker MPM ) 是 进程 -线程 混合 方式 。Apache 为 传人 的 每 个 
请 求 创建 一 个 新 的 处 理 线程 , 这 样 对 内 存 的 使 用 更 加 有 效 , 但 这 种 方式 要 求 应 用 必 
须 是 线程 安全 的 。 虽 然 现在 流行 的 PHP 语言 是 线程 安全 的 ， 但 却 无 法 保证 和 它 一 
起 被 使 用 的 各 种 库 也 是 线程 安全 的 。 

不 管 哪 种 方法 , 它们 都 可 以 应 对 并 发 请 求 。 如 果 五 个 用 户 在 同一 时 间 访 问 一 个 Web 应 
H, 并且 服务 占 也 进行 了 相应 设置 ， 那 么 Web 服务 需 就 可 以 同时 处 理 五 个 请 求 。 


Node 的 处 理 方式 与 上 面 两 种 不 同 。 当 您 启动 Node 应 用 程序 时 , 它 会 被 创建 并 运行 
在 一 个 单线 程 上 。Node 会 等 待 应 用 程序 启动 完成 并 开始 捕获 请 求 。 在 未 处 理 完 当 
前 请 求 时 ， 其 他 请 求 是 不 能 被 人 处理 的 。 

这 种 处 理 方式 听 起 来 并 不 是 很 有 效率 ,如果 Node 是 通过 事件 循环 和 回调 因数 实现 
异步 运行 (在 Node 中 ， 事 件 循环 一 般 指 轮 询 指 定 事 件 类 型 并 在 合适 的 时 间 调 用 事 
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件 处 理 程序 ， 而 回调 卫 数 就 是 事件 处 理 程序 ) 的 话 ， 它 是 不 应 该 低 效 的 。 


实际 上 , 与 一 般 单线 程 应 用 不 同 ， 当 Node 应 用 程序 接收 到 用 户 请 求 时 ， 虽 然 它 会 
严格 按照 请 求 顺序 初始 化 这 些 资源 请 求 操 作 〈 如 数据 库 请 求 或 文件 访问 )， 但 并 不 
会 一 下 等 竺 操作 完成 或 结果 返回 。 相 反 , ESERE R PA IRR AE 
被 请 求 的 资源 准备 好 或 被 请 求 的 操作 完成 时 , 特定 的 事件 会 被 触发 , 关联 的 回调 也 
数 也 会 被 执行 ， 回 调 函 数 会 用 请 求 到 的 资源 或 操作 结果 来 做 另 一 些 事 情 。 


如 果 五 个 用 户 在 同一 时 间 访问 Node 应 用 程序 ， 并 且 该 应 用 程序 需要 访问 同一 个 文 
件 中 的 资源 时 ，Node 会 为 每 个 文件 访问 请 求 附加 一 个 回调 函数 但 并 不 等 待 返回 。 
当 资源 变 为 可 用 时 ， 回 调 函数 会 被 调用 ， 最 终 依次 满足 每 个 用 户 的 需求 。 在 此 其 
间 ，Node 应 用 仍然 可 以 处 理 其 他 同样 或 不 同类 型 的 用 户 请 求 。 


尽管 Node 应 用 程序 不 是 真正 的 并 行 处 理 用 户 请 求 ， 但 其 设计 方式 使 得 应 用 能 党 
忙 旦 高 效 地 处 理 用 户 请 求 ， 所 以 大 多 数 人 通常 不 会 察 完 到 任何 的 啊 应 延迟 。 最 重 
要 的 是 ， 它 能 非常 有 效 地 使 用 内 存 和 其 他 有 限 的 计算 机 资源 。 


1.3.1 使 用 异步 方式 读 取 文件 

为 了 描述 Node 的 异步 特性 ,示例 1-2 修改 了 之 前 章节 使 用 的 Hello World 程序 。 
它 不 再 输出 “Hello,World!”, 而 是 打开 先前 创建 的 helloworld.js 文件 并 将 其 内 容 
输出 给 客户 端 。 


示例 1-2 异步 方式 地 打开 文件 并 写 入 数据 


// load http module 
var http = require('http'); 
var fs = require('fs'); 


// create http server 
http.createServer(function (req, res) { 


// open and read in helloworld.js 
fs.readFile('helloworld.js', ‘utf8', function(err, data) { 


res.writeHead(200, {'Content-Type': ‘text/plain’ }); 
if (err) 

res.write('Could not find or open file for reading\n'); 
else 


// if no error, write JS file to client 
res.write(data) ; 
res.end(); 


J); 
}).listen(8124, function() { console. log('bound to port 8124');}); 


console. log( ‘Server running on 8124/'); 


本 示例 中 使 用 了 一 个 新 的 文件 系统 模块 (fs )。 该 模块 对 标准 的 POSIX 文件 操作 进行 了 
封装 ， 提 供 了 包括 打开 文件 和 访问 文件 内 容 等 操作 。 示 例 1-2 使 用 了 模块 中 的 readFile 
方法 ， 并 传人 了 多 个 参数 ， 包 括 文件 名 称 、 文 件 编码 方式 以 及 匿名 回调 函数 。 


在 示例 1-2 中 ， 我 想 指 出 两 个 有 关 异 步行 为 的 实例 ， 它 们 分 别 是 附加 在 readFile 方 
法 和 listen 方法 上 的 回调 毅 数 。 


正如 前 面 所 讨论 的 ， 使 用 listen 方法 可 以 告诉 HTTP server 对 象 监听 指定 端口 上 的 
连接 。Node 不 会 阻塞 并 等 待 连接 建立 , 所 以 如 果 我 们 需要 在 连接 建立 时 做 些 事情 ， 
就 需要 提供 了 一 个 回调 孙 数 ， 如 示例 1-2 所 示 。 


当 网 络 连接 建立 时 会 触发 监听 事件 ， 该 事件 会 触发 listen 方法 绑 定 的 回调 师 数 ， 进 
而 将 信息 输出 到 控制 合 。 


第 二 ， 也 是 更 重要 的 实例 是 附加 在 readFile 上 的 回调 函数 。 相 对 来 说 ， 访 问 文件 是 
一 个 耗 时 的 操作 。 如 果 一 个 单线 程 应 用 程序 被 多 个 客户 同时 访问 ， 而 该 应 用 处 理 每 一 
个 请 求 时 都 需要 进行 文件 访问 操作 的 话 ， 它 可 能 很 快 就 会 陷入 凑 痪 而 无 法 使 用 。 
解决 方法 就 是 采用 异步 方式 打开 文件 和 读 取 文件 内 容 。 只 有 当 内 容 已 经 读 和 数据 组 
冲 区 (或 谈 取 失败 时 ), 附加 在 readFile 方法 上 的 回调 函数 才 会 被 调用 。 错误 信息 (如 
果 有 的 话 ) 和 读 取 到 的 数据 ( 如 果 没 有 错误 发 生 时 ) 会 作为 参数 传送 给 回调 毅 数 。 
在 回调 站 数 中 需要 进行 错误 检查 ， 如 果 不 存 在 错误 ， 则 将 读 取 到 的 数据 返回 给 
Be Yii o 


1.3.2 ”观察 异步 程序 流程 

大 多 数 人 使 用 JavaScript 编写 客户 问 应 用 程序 ， 这 些 程序 只 能 被 用 户 在 单个 浏览 器 
中 运行 。 而 在 服务 端 使 用 JavaScript 编写 程序 可 能 看 上 去 会 有 些 古 怪 和 陌生 。 创 建 
人 允许 多 人 同时 访问 的 JavaScript 服务 应 用 可 能 就 更 让 人 觉得 陌生 了 。 

Node 的 事件 循环 和 异步 郧 数 调用 可 以 帮助 我 们 ,这 让 编写 服务 端 JavaScript 程序 
变 得 容易 且 吏 有 信心 。 但 一 定 要 注意 的 是 , 我 们 正在 一 个 新 的 不 同 以 往 的 环境 中 做 
JavaScript 开发 。 

为 了 更 好 地 描述 新 环境 的 不 同 , 我 创建 了 两 个 新 的 应 用 : 一 个 提供 服务 ， 另 一 个 用 
于 测试 服务 。 示 例 1-3 显示 了 服务 程序 的 代码 。 

在 代码 中 ， 一 个 函数 被 调用 ， 以 同步 方式 按 顺 序 输出 从 1 一 100 的 数字 。 然 后 程 
序 以 类 似 于 示例 1-2 的 方式 打开 一 个 文件 ， 但 这 次 文件 名 是 以 字符 串 参 数 的 形式 
传递 给 困 数 的 。 此 外 ， 程 序 还 使 用 了 一 个 定时 需 ， 文 件 打开 操作 被 安排 在 定时 需 
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超时 之 后 执行 。 
示例 1-3 输出 数字 序列 和 文件 内 容 的 服务 程序 


var http = require('http'); 
var fs = require('fs'); 


// write out numbers 
function writeNumbers(res) { 


var counter = 0; 


// increment global, write to client 
for (var i = 0; i<100; i++) { 
counter++; 
res.write(counter.toString() + '\n'); 
} 
j 


// create http server 
http.createServer(function (req, res) { 


var query = require('url').parse(req.url).query; 
var app = require('querystring').parse(query).file + ".txt"; 


// content header 
res.writeHead(200, {'Content-Type': 'text/plain'}); 


// write out numbers 
writeNumbers(res) ; 


// timer to open file and read contents 
setTimeout(function() { 


console.log('opening ' + app); 
// open and read in file contents 
fs.readFile(app, ‘utf8', function(err, data) { 


if (err) 
res.write('Could not find or open file for reading\n'); 
else { 
res.write(data) ; 
} 
// response is done 
res.end(); 
}); 
}, 2000); 


})-listen(8124); 


console.log('Server running at 8124'); 


输出 数字 的 循环 体 起 到 了 延迟 应 用 程序 执行 的 效果 ， 以 便 模 拟 密 集 计 算 过 程 ， 
该 过 程 会 引起 应 用 程序 阻塞 下 到 计算 完成 。 在 这 里 setTimeout 是 另 一 个 异步 函 
数 ， 它 会 紧 接 着 调用 第 二 个 异步 国 数 : readFile。 所 以 该 应 用 程序 结合 了 异步 和 
同步 流程 。 
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创建 一 个 名 为 main.txt 的 文本 文件 ,可 以 包含 任何 你 想 要 的 内 容 。 运 行 应 用 程序 并 
通过 Chrome 浏览 磺 访 问 ， 访 问 时 使 用 的 url 需要 带 有 file=name 的 查询 字段 , 应 用 
程序 将 生成 如 下 控制 台 输 出 : 


Server running at 8124/ 
opening main.txt 
opening undefined.txt 


前 两 行 输出 信息 很 容易 理解 。 第 一 行 由 程序 末尾 console.log 输出 , 第 二 行 是 在 文件 
被 打开 时 输出 的 。 但 是 ， 第 三 行 的 undefined.txt 是 怎么 回 事 ? 


其 实 ， 当 处 理 来 目 浏览 器 的 Web 请 求 时 ， 浏 览 器 可 能 会 发 送 多 个 请 求 。 例 如 ， 一 般 
训 览 需 可 以 发 送 第 二 个 请 求 ， 寻 找 一 个 叫 favicon.ico 的 文件 。 正 因为 如 此 ， 当 你 在 处 
理 查询 字符 串 时 ， 你 必须 检查 看 看 需要 的 数据 是 否 被 提供 ， 并 忽略 没有 数据 的 请 求 。 


警告 

-S 当期 望 从 查询 字符 串 中 获取 菜 些 参数 时 ， 浏 览 器 发 送 多 个 请 求 的 特 
点 可 能 会 影响 到 你 的 应 用 程序 。 因 此 ， 必 须 相 应 的 调整 应 用 ， 并 在 
几 个 不 同 的 浏览 器 上 进行 测试 。 


到 目前 为 止 ， 我 们 对 Node 应 用 程序 所 做 的 所 有 测试 都 是 从 浏览 器 中 进行 的 。 这 样 
我 们 无 法 对 其 进行 压力 测试 来 体现 Node 应 用 程序 的 异步 特性 。 


示例 1-4 是 一 段 非常 简单 的 测试 代码 。 它 使 用 HTTP 模块 多 次 向 服务 程序 发 送 请 求 。 
这 些 请 求 并 不 是 按 异步 方式 发 送 的 。 然 而 ,我 们 同时 也 可 以 使 用 浏览 器 访问 该 服务 。 
两 者 相 结 合 ， 就 可 以 达到 异步 测试 应 用 程序 的 目的 。 


提示 
14 章 将 介绍 如 何 创建 出 步 测试 应 用 程序 。 





示例 1-4 测试 小 程序 ， 调 用 Node 服务 程序 2000 次 


var http = require('http'); 


//The url we want, plus the path and options we need 
var options = { 
host: ‘localhost’, 
port: 8124, 
path: '/?file=secondary', 
method: ‘GET’ 
}; 
var processPublicTimeline = function(response) { 


// finished? ok, write the data to a file 
console. log('finished request’); 
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上 


for (var i = 0; i < 2000; i++) { 
/ make the request, and then end it, to close the connection 
http.request(options, processPublicTimeline) .end(); 


创建 第 二 个 文本 文件 ， 并 命名 为 secondary.txt。 内 容 与 main.txt 有 显著 不 同 即 可 。 
在 确定 Node 服务 程序 运行 起 来 后 ， 启 动 测试 程序 : 


node test.js 


在 测试 程序 运行 的 同时 , 使 用 浏览 器 手动 访问 服务 程序 。 观 察 服务 程序 在 控制 台 
输出 信息 ， 你 会 看 到 来 自 浏 览 句 的 手动 请 求 和 来 自 测 试 程序 的 自动 请 求 都 能 被 处 
理 。 并 且 ， 结 果 与 我 们 所 期 望 的 一 致 ， 请 求 到 的 页 面 中 包含 了 如 下 信息 : 


e 1 到 100 的 数字 
。 文本 文件 的 内 容 ， 在 本 示例 中 是 main.txt 的 内 容 。 


现在 ， 让 我 们 尝试 做 一 些 改动 。 在 示例 1-3 中 ， 将 循环 体 中 计数 用 的 局 部 变量 counter 改 
为 全 局 变量 ， 并 重新 启动 应 用 程序 。 然 后 运行 测试 程序 ， 并 在 浏览 硕 中 访问 该 页 面 。 


输出 结果 显然 发 生 改 变 。 返 回 的 页 面 内 容 不 再 是 从 1 开始 到 100 的 数字 , 而 是 返回 从 类 
似 2601 和 26301 这 样 的 数字 开始 的 ， 按 顺序 排列 的 连续 99 个 数字 ， 只 是 初始 值 不 同 。 


原因 必然 是 因为 使 用 了 全 局 变量 counter. AAEM AA Pom, As 
测试 程序 也 在 做 同样 的 事 ， 他 们 都 会 更 新 counter。 男 外 由 于 手动 和 自动 测试 程序 
的 请 求 被 按照 顺序 一 个 个 的 处 理 , 因此 没有 争 用 共享 数据 的 情况 发 生 (在 多 线程 环 
境 中 ， 并 行 访 问 共 享 数 据 同 时 保证 线程 安全 是 最 主要 的 问题 )， 如 果 你 之 前 有 期 望 
输出 一 致 的 起 始 值 ， 这 里 的 结果 可 能 会 让 你 感到 些许 意外 。 


现在 再 次 更 改 应 用 程序 ,但 这 次 我 们 删除 变量 app 之 前 的 var 关键 字 ( “不 小 心 的 ” 
使 其 成 为 一 个 全 局 变量 )。 曾 几何 时 ， 在 编写 客户 问 JavaScript 时 ， 我们 总 是 忘记 
使 用 var KEF o 或许 也 只 有 当 我 们 程序 中 用 到 的 某 些 库 使 用 了 相同 的 变量 名 时 ， 
才 会 发 现 这 种 错误 。 

运行 测试 程序 同时 通过 浏览 器 手动 访问 Node 服务 程序 多 次 。 你 会 发 现 浏览 器 得 到 的 
页 面 中 偶尔 会 包含 secondary.txt 文件 的 内 容 ， 而 不 是 期 望 的 main.txt 文件 内 容 。 这 是 
因为 在 应 用 程序 处 理 请 求 ( 带 有 文件 名 ) 和 真正 执行 文件 打开 操作 之 间 有 一 段 时 间 间 
Bas, 在 此 间 隅 期 间 测 试 程序 的 持续 访问 会 使 得 服务 程序 修改 app 变量 。 测 试 程序 之 所 
以 能 够 引起 这 样 的 问题 ,是 因为 我 们 做 了 一 个 异步 功能 调用 , 在 异步 调用 开始 执行 而 
没有 完成 前 ，Node 会 放弃 对 当前 请 求 处 理 过 程 的 控制 权 来 处 理 另 一 个 用 户 请 求 。 


Aa 提示 
这 个 示例 说 明了 正确 使 用 var 关键 字 在 Node 中 是 至 关 重 要 的 。 
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1.4 Node 的 优势 


现在 ， 你 至 少 已 经 安装 了 一 个 〈 或 多 个 ) 可 用 的 Node 版 本 。 


你 也 有 机 会 去 创建 多 个 Node 应 用 程序 ， 并 且 通 过 测试 发 现 同 步 与 异步 编码 之 间 的 
差异 (以 及 不 小 心 忘记 了 var 关键 字 的 情况 )。 


Node 使 用 的 函数 调用 并 不 都 是 异步 的 。 一 些 对 象 针 对 同一 功能 可 能 会 同时 提供 同步 与 异 
步 版 本 的 实现 。 尽 管 如 此 , 如 果 你 能 尽 可 能 多 的 进行 异步 编码 , 将 会 使 Node 工作 得 更 好 。 


Node 的 事件 循环 和 回调 冰 数 给 我 们 带 来 了 两 大 好 处 。 


首先 , 应 用 程序 可 以 很 容易 地 扩展 , 因为 执行 一 个 单线 程 并 不 会 有 非常 大 的 资源 开 
销 。 如 果 我 们 用 PHP 创建 一 个 类 似 于 示例 1-3 的 Node 应 用 时 , 用户 会 看 到 相同 的 
页 面 (但 你 的 系统 肯定 会 注意 到 其 中 的 差别 )。 如 果 你 在 Apache 中 运行 该 PHP 应 
用 程序 并 默认 使 用 prefork MPM, 那么 在 每 次 应 用 程序 接收 到 请 求 时 ， 请 求 将 被 放 
在 一 个 单独 的 子 进程 中 来 处 理 。 倘 硅 你 能 够 拥有 一 个 强大 有 旦 高 效 的 负载 均衡 系 
统 ， 同 时 并 行 运行 (最 多 ) 几 百 个 子 进程 或 许 是 有 可 能 的 。 不 过 当 访 问 量 超过 这 个 
数字 时 ， 就 意味 着 客户 端 需要 等 待 响应 了 。 

Node 的 第 二 个 优势 在 于 无 需 诉求 于 多 线程 开发 ， 却 达到 了 节约 又 能 高 效 使 用 资源 
的 目的 。 换 名 话说 ,你 不 必 创 建 一 个 线程 安全 的 应 用 程序 。 倘 若 你 曾经 开发 过 要 求 
线程 安全 的 应 用 程序 ， 或 许 此 时 你 会 感到 非常 欣 嘉 。 


无 论 如 何 ， 正 如 前 面 示例 应 用 程序 所 展示 的 那样 ， 你 不 是 在 开发 浏览 器 中 运行 的 
JavaScript 应 用 程序 。 当 你 开发 异步 应 用 时 ， 不 能 假设 一 个 异步 轴 数 在 另 一 个 函数 
被 调用 前 就 执行 完成 ， 因 为 这 是 无 法 保证 的 〈 除 非 你 在 第 一 个 回调 函数 中 调用 另 一 
个 )。 此 外 ， 全 局 变量 在 Node 中 是 非常 危险 的 ， 特 别 是 在 你 忘记 了 var 关键 字 时 。 


虽然 这 些 问题 存在 ， 但 并 不 妨碍 我 们 在 工作 使 用 Node， 特 别 是 考虑 到 它 的 低 资源 
需求 优势 ， 以 及 不 必 担 心 线程 安全 间 题 。 
we ”提示 
或 许 喜欢 Node 的 原因 也 可 以 是 毫 无 顾虑 地 写 JavaScript 代码 而 无 需 担 
O la 
~ Gist oS TE6 T. 
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第 2 章 
Node 5 REPL 


尝试 使 用 Node 编写 自 定 义 的 模块 或 者 应 用 程序 时 ， 并 不 需要 每 次 运行 写 好 的 
JavaScript 文件 来 测试 代码 功能 。Node 有 一 个 交互 式 组 件 称 为 REPL 
(read-eval-print-loop ， 读 取 求 值 列 印 循环 )， 这 将 是 本 章 的 主题 。 

REPL ( 发音 为 “repple”) 支持 简化 的 Emacs 风格 行 编辑 和 一 小 部 分 基本 命令 。 在 
REPL 中 输入 任何 内 容 都 与 用 Node 运行 JavaScript 编写 的 文件 具有 相同 的 处 理 方 式 。 
事实 上 , 可 以 使 用 REPL 编写 整个 应 用 程序 一 一 这 样 就 可 以 频繁 地 对 程序 进行 测试 。 
本 章 涉 及 REPL 的 一 些 有 趣 的 技巧 以 及 如 何 使 用 这 些 技巧 , 包括 如 何苦 换 浏览 历史 
命令 的 底层 机 制 以 及 命令 行 编辑 等 内 容 。 


最 后 ,如 果 内 建 的 REPL 不 能 提供 你 所 需要 的 交互 环境 , 本 章 的 后 续 部 分 会 介绍 用 

于 创建 自 定 义 REPL 的 API。 

提示 

如 何 使 用 REPL: http://docs.nodejitsu.com/articles/REPL/how-to-use- 

sw nodejs- replNodejitsu。 网 站 提供 的 如 何 创 建 自 定义 REPL 的 教程 : 
http://docs.nodejitsu.com/ articles/REPL/how-to-create-a-custom-repl. 


2.1 REPL: 先睹为快 和 未 定义 的 表达 式 
只 需要 输入 node 命令 就 可 以 运行 repl， 不 需要 提供 任何 Node 应 用 文件 作 参 数 : 
$ node 


REPL 默认 尖 括 号 > 为 命令 行 提示 符 。 在 该 符号 之 后 输入 的 任何 内 容 都 由 底层 的 V8 
JavaScript 引擎 进行 处 理 。 
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REPL 的 使 用 很 简单 ， 就 像 在 文件 中 编写 JavaScript 一 样 : 


REPL 可 以 即时 打印 输入 的 任何 表达 式 的 结果 。 在 上 面 例子 中 , 表达 式 的 结果 是 2。 
下 面 这 个 例子 中 表达 式 结果 是 有 三 个 元 素 的 数组 : 


可 以 使 用 下 划 线 “ ”调用 上 一 个 表达 式 。 本 例 中 , a 为 2， 绪 宁 表 达 式 两 次 目 增 1: 
a= 2; 


++; 


mV WV NN V 


还 可 以 用 下 划 线 访问 该 对 象 的 属性 或 者 调用 方法 : 


> [‘apple', 'orange', 'lime'] 


[ 'apple', 'orange', 'lime'] 
> _.length 

3 

>3+ 4 


7 
> _.toString(); 
17! 


在 REPL 中 也 可 以 使 用 var 关键 字 。 可 以 在 之 后 通过 变量 名 访问 表达 式 或 者 变量 。 
但 是 这 样 可 能 会 得 到 意料 之 外 的 结果 。 比 如 ， 在 REPL 中 输入 以 下 命令 行 : 


var a = 2; 


该 表达 式 返 回 值 并 不 是 2， 而 是 undefined。 表 达 式 结果 为 undefined 的 原因 是 变量 
赋值 的 表达 式 并 不 返回 变量 的 值 作为 表达 式 的 值 。 


理解 以 下 代码 ， 多 少 可 以 解释 REPL 中 的 这 种 现象 : 


console.log(eval('a = 2')); 
console.log(eval('var a = 2')); 


将 上 两 行 代码 写 入 文件 并 用 Node 运行 ， 返 回 值 如 下 : 


undefined 


第 二 行 代码 并 没有 返回 结果 给 eval， 因 此 返回 值 为 undefined。 要 记得 ，REPL 是 
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read-eval-print loop， 重 点 在 eval， 就 是 求 值 。 


但 是 ,在 REPL 中 你 仍旧 可 以 使 用 该 变量 ， 像 在 Node 应 用 中 一 样 : 


> var a = 2; 
undefined 

> att; 

2 

> att; 

3 


后 两 条 命令 有 返回 值 ， 由 REPL 打印 输出 。 


a, 提示 
Ey > 后 会 说 明 如 何 创建 自 定义 的 REPL 


a 
a, 
. 





不 输出 undefined, 参见 2.3.3 7. 


FE Ctrl+C 键 两 次 或 者 Ctrl+D 键 一 次 退出 REPL. 2.3.1 节 介 绍 了 其 他 退出 方法 。 


2.2 ”REPL 的 优势 :更 好 地 理解 表层 之 下 的 JavaScript 
下 例 是 一 个 REPL 的 典型 示范 : 


> .3 2 Ls 
false 


这 段 代 码 很 好 地 解释 了 REPL 的 工作 原理 。 一 眼看 上 去 会 认为 期 望 的 输出 值 为 
true， 因 为 3 大 于 2，2 大 于 1。 但 是 在 JavaScript 中 ， 表 达 式 是 从 左 到 右 计 算 的 ， 
每 个 表达 式 的 返回 值 作 为 下 一 个 表达 式 的 一 部 分 进行 计算 。 


以 下 REPL 中 的 语句 可 以 帮助 你 更 好 地 理解 前 端 代码 : 


>3>2>1; 
false 

> 3 > 23 
true 

> true > 1; 
false 


现在 这 个 结果 看 起 来 就 合理 多 了 。 整 个 计算 过 程 如 下 : 首先 计算 表达 式 3>2， 返 回 
true; 之 后 用 true 值 与 数字 1 进行 比较 。JavaScript 提供 了 目 动 类 型 转换 ，true 和 | 
被 认为 是 相等 的 值 。 因此 ， true 不 大 于 l, 返回 值 为 false。 

REPL 有 助 于 我 们 发 现 JavaScript 中 这 些 有 趣 的 地 方 。 希 望 代码 经 过 REPL 的 测试 之 
后 ， 应 用 程序 中 不 会 出 现 无 法 预测 的 结果 〈 比如 期 望 得 到 true 却 得 到 了 false )。 


22 22s 


2.3 ”多 行 以 及 更 复杂 的 JavaScript 


你 可 以 像 写 文件 一 样 在 REPL 中 输入 JavaScript， 包 括 导 入 module 的 require 语句 。 
以 下 代码 显示 了 如 何 使 用 Query String(qs)module: 


U? 


node 


V 


qs = require('querystring'); 

unescapeBuffer: [Function], 

unescape: [Function], 

escape: [Function], 

encode: [Function], 

stringify: [Function], 

decode: [Function], 

parse: [Function] } 

> val = qs.parse('file=main&file=secondaryétest=one').file; 
[ 'main', 'secondary' | 


a 


由 于 没有 使 用 var 关键 字 ， 表 达 式 的 结果 被 直接 输出 ， 在 本 例 中 是 querystring WAN 
接口 。 预 期 之 外 的 收获 是 用 这 种 方式 不 仅 可 以 访问 对 象 ， 同 时 还 可 以 了 解 更 多 关于 对 
象 的 可 用 接口 。 但 是 ， 如 果 不 想 看 到 可 能 出 现 的 长 文本 输出 ， 请 使 用 var 关键 宁 : 


> var qs = require('querystring'); 


可 以 用 gs 变量 访问 querystring 对 象 的 任 一 方法 。 


为 了 兼容 外 部 模块 ，REPL 可 以 处 理 多 行 表达 式 ， 提 供 了 可 以 让 套 使 用 的 文本 标识 
待 ， 跟 在 大 括号 他 之 后 : 


> var test = function (x, y) { 
. var val = x * y; 
. return val; 
e E 

undefined 

> test(3,4); 

12 


REPL 提供 重复 的 点 “.” 符 号 跟 在 开放 的 大 括号 后 面 表示 输入 命令 未 完成 ， 该 符号 
同样 可 以 用 于 不 财 合 的 小 括号 : 


> test(4, 
é) 
20 


层级 间 的 递 进 需 要 更 多 的 点 符号 。 这 在 交互 式 环境 中 是 必须 的 , 否则 会 在 输入 过 程 
中 迷失 了 目 己 当前 所 在 的 位 置 : 


> var test = function (x, y) { 
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。 Var test2 = function (x, y) { 
stele return x * y; 


. return test2(x,y); 
。} 
undefined 
> test (3,4); 
12 
> 


以 下 代码 是 一 个 完整 的 Node 应 用 程序 ， 可 以 在 REPL 中 输入 或 者 复制 粘贴 并 运行 : 


> var http = require('http'); 
undefined 
> http.createServer(function (req, res) { 


// content header 
res.writeHead(200, {'Content-Type': 'text/plain'}); 


res.end("Hello person\n") ; 
}) .listen (8124); 
{ connections: 0, 
allowHalfOpen: true, 
_handle: 
{ writeQueueSize: 0, 
onconnection: [Function: onconnection], 
socket: [Circular] }, 
_events: 
{ request: [Function], 
connection: [Function: connectionListener] }, 
httpAllowHalfOpen: false } 
> 
undefined 
> console.log('Server running at http://127.0.0.1:8124/'); 
Server running at http://127.0.0.1:8124/ 
Undefined 


可 以 通过 浏览 器 访问 该 应 用 , 这 与 用 Node 运行 程序 文件 没有 差别 。 而 且 , 从 REPL 
返回 的 response 如 上 述 粗 体 文本 所 示 。 


事实 上 ，REPL 最 实用 之 处 在 于 快捷 查看 对 和 象 。 例如，Node 核心 对 象 global 在 Node.js 
官网 上 文档 很 少 。 为 了 更 好 地 了 解 该 对 象 ， 在 REPL 中 将 global 对 象 传递 给 
console.log 方法 ， 如 下 : 


> console.log(global) 
Pe TT SFA FAIA) ZAR : 


> gl = global; 
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这 里 不 青 复制 REPL 中 的 运行 结果 。global 对 象 接口 非常 多 ,你 可 以 安装 后 自己 尝 
试 。 这 个 练习 的 关键 在 于 告知 一 种 可 以 在 任何 时 候 简 单 快捷 地 查看 对 象 接口 的 方 
法 ， 不 必 去 死记 便 痛 逢 要 调用 什么 方法 、 什 么 属性 是 可 用 的 。 


Wa 提示 
更 多 关于 global 对 象 请 见 第 3 章 ， 


在 REPL 中 可 以 使 用 上 下 稍 头 遍历 之 前 输入 的 命令 。 这样 可 以 很 方便 地 查看 之 前 的 
操作 ， 也 可 以 一 定 程度 上 提供 编辑 历史 命令 的 能 力 。 


阅读 REPL 中 的 如 下 代码 : 
> Var myFruit = function(fruitArray,pickOne) { 
. return fruitArray[pickOne - 1]; 
ee 
undefined 
> fruit = ['apples','oranges','limes','cherries']; 
[ 'apples', 
"oranges', 
‘limes’, 
‘cherries' ] 
> myFruit (fruit,2); 
"oranges' 
> myFruit (fruit, 0); 
undefined 
> var myFruit = function(fruitArray,pickOne) { 
. if (pickOne <= 0) return ‘invalid number'; 
.. return fruitArray[pickOne - 1]; 
E ore 
undefined 


> myFruit (fruit,0); 
‘invalid number' 

> myFruit (fruit,1)>; 
‘apples' 


在 以 上 输入 中 没有 体现 出 来 的 是 ， 每 次 在 修改 方法 检查 输入 值 时 ， 首 先 向 上 查找 
之 前 的 命令 找到 琐 数 定义 ， 回 车 重新 运行 该 方法 。 每 添加 新 的 语句 ， 再 用 方向 键 
重复 上 述 操作 直到 完成 该 郴 数 。 同 时 也 使 用 向 上 方向 键 重复 困 数 调用 ， 输 出 


undefined, 


看 起 来 似乎 多 做 了 很 多 工作 只 是 为 了 避免 重复 输入 , 但 是 如 果 使 用 正则 表达 式 ， 如 
以 下 例子 : 


> var ssRe = /*\d{3}-\d{2}-\d{4}$/; 
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undefined 

> ssRe.test('555-55-5555'); 

true 

> var decRe = /*\s* (\+1-) 2.¢(\d+(\.\d+) ?) | (\.\d+t) ) \s*$/;7 
undefined 

> decRe.test (56.5); 

true 


则 在 写 出 一 个 正确 的 正则 表达 式 之 前 通常 要 反复 修改 好 几 次 (我 并 不 擅长 正则 表达 式 )。 
用 REPL 做 正则 表达 式 的 测试 非常 便捷 ， 可 以 避 倪 重复 输入 很 长 的 正则 表达 式 的 痛 杏 。 


幸运 的 是 在 REPL 中 只 需要 使 用 方向 键 就 可 以 找到 创建 正则 表达 式 的 命令 ， 修 改 ， 
回 车 然后 继续 测试 。 


除了 方向 键 ， 还 可 以 使 用 Tab 键 目 动 补 人 全。 例如， 在 命令 行 中 输入 va, FE Tab 键 ， 
REPL 会 自动 补 全 为 var。Tab 也 可 以 用 于 自动 补 全 任意 的 全 局 或 者 局 部 变量 。 
表 2-1 列 出 了 一 些 REPL 中 的 按键 功能 。 


表 2-1 REPL 中 的 键盘 控制 

键盘 输入 J 能 
Ctrl+C 终止 当前 命令 。 按 Ctrl+C 键 两 次 直接 退出 
Ctrl+D 退出 REPL 

Tab 自动 补 全 全 局 或 者 局 部 变量 

向 上 键 查找 该 条 命令 之 前 的 输入 
回 下 键 查找 该 条 命令 之 后 的 输入 

下 划 线 (_) 上 一 条 表达 式 的 输出 


如 果 你 担心 花 很 多 时 间 在 REPL 中 编程 但 是 结束 时 却 没有 什么 可 以 保存 下 来 的 文 
件 ， 不 用 担心 ，.save 命令 可 以 保存 当前 的 上 下 文 输入 。 这 一 命令 和 其 他 REPL 的 
fit a 令 会 在 下 一 P 节 中 讲 到 。 
2.3.1 REPL 命令 


REPL 提供 了 一 些 常用 命令 的 接口 。 在 前 一 节 中 提 到 了 .save 命令 , 该 命令 将 当前 语 
境 中 的 输入 保存 在 文件 中 。 除 非特 意 创建 了 一 个 新 的 语 境 或 者 使 用 .clear 命令 ， 该 
文件 会 包含 在 当前 REPL 中 所 有 的 输入 : 


> .save ./dir/session/save.js 


保存 下 来 的 只 有 你 自己 直接 输入 的 文本 ， 就 像 在 文本 编辑 货 中 直接 输入 的 一 样 。 
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以 下 是 一 个 完整 的 REPL 命令 以 及 功能 列表 : 
.break 


如 果 多 行 输入 发 生 混乱 不 知道 当前 位 置 时 ,使 用 .break 会 重新 开始 。 不 过 会 丢 
失 之 前 输入 的 多 行内 容 。 


.clear 
重 置 语 境 并 清空 所 有 表达 式 。 该 命令 可 以 使 你 重头 再 来 。 
exit 
退出 REPL. 
help 
显示 所 有 可 用 的 REPL 命令 。 
save 
将 当前 REPL 会 话 保存 至 文件 。 
load 
将 文件 加 载 到 当前 会 话 ( .load/path/to/file.js ). 
如 果 使 用 REPL 作为 开发 应 用 程序 的 编辑 器 ， 以 下 提示 或 许 会 有 帮助 : 


经 常 使 用 .save 命令 保存 当前 工作 。 尽 管 当前 命令 可 以 在 历史 记录 中 查找 ， 但 是 重 
建 代码 依然 是 个 很 痛苦 的 过 程 。 


提 到 关于 命令 的 记录 ， 接 下 来 就 会 涉及 如 何 定制 自己 的 REPL。 


2.3.2 REPL 和 riwrap 


Node.js 官网 上 关于 REPL 的 文档 提 到 过 设置 环境 变量 ， 所 以 可 以 在 REPL 中 使 用 
rlwrap。 那 么 ，rlwrap 是 什么 ?又 为 什么 要 在 REPL 中 使 用 rlwrap Ye? 


rlwrap 将 GNU readline 库 的 功能 添加 至 命令 行 , 增加 键盘 输入 的 灵活 性 。 它 监听 键 
盘 输 入 并 提供 更 多 的 功能 ， 比 如 增强 行 编辑 以 及 提供 命令 历史 浏览 功能 。 


需要 安装 rlwrap 和 readline 以 便 在 REPL 中 使 用 这 一 功能 ， 大 部 分 Unix 系统 提供 
了 简单 的 包 安 装 。 比 如 ， 在 我 的 Ubuntu 系统 中 ， 安 装 rlwrap 只 需要 一 行 命令 : 
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apt-get install rlwrap 


Mac 用 户 可 以 使 用 目 己 的 安装 工具 安装 该 程序 。Windows 用 户 需要 使 用 Unix 环境 
模拟 需 ， 比 如 Cygwin. 


下 面 是 一 个 简单 的 示例 ， 如 何在 REPL 中 使 用 rlwrap 将 REPL 的 提示 改 为 紫色 : 
env NODE NO READLINE=1 rlwrap -ppurple node 

如 果 和 希望 REPL 的 提示 符 一 直 是 紫色 的 ， 可 以 在 bashrc 文件 中 添加 别名 〈alias ): 
alias node="env NODE NO READLINE=1 rlwrap -ppurple node" 

同时 改变 提示 符 和 颜色 ， 命 令 如 下 : 
env NODE_NO READLINE=1 rlwrap -ppurple -S "::>" node 


现在 提示 符 变 为 以 下 符号 并 且 是 紫色 的 : 


Eea 


rlwrap 组 件 的 特殊 之 处 在 于 它 在 多 个 REPL 窗口 中 浏览 命令 历史 的 功能 。REPL $A 
认 只 能 浏览 当前 REPL 会 话 的 命令 历史 , 但 是 使 用 rlwrap, 在 关闭 当前 会 话 下 一 次 
重新 进入 REPL 时 , 不 仅 可 以 浏览 当前 会 话 的 历史 命令 , 并 且 可 以 浏览 之 前 会 话 的 
命令 历史 (以 及 其 他 命令 行 输入 ) 在 下 面 例子 中 ,显示 的 命令 行 不 是 手动 输入 的 ， 
而 是 通过 方向 键 从 命令 历史 中 找 出 来 的 : 

# env NODE NO READLINE=1 rlwrap -ppurple -S "::>" node 

::>e = ['a','b']; 

[tag < 

21> 3 > a am l} 

false 
即使 如 此 强大 ， 但 是 每 次 输入 无 返回 值 的 表达 式 时 依然 得 到 undefined. 
然而 ， 这 一 现象 是 可 以 改变 的 ， 这 就 是 下 一 市 中 将 要 讨论 的 功能 一 一 创建 自 定 
义 的 a 


2.3.3 定制 REPL 


Node 提供 了 定制 REPL 的 功能 。 为 了 实现 该 功能 ,首先 需要 引入 REPL 模块 
(repl ): 


Var repl = require("repl"); 
通过 在 rep] 对 象 上 调用 start 方法 创建 新 的 REPL。 调 用 该 方法 的 语法 是 : 


repl.start([prompt], [stream], [eval], [useGlobal], [ignoreUndefined]); 
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所 有 参数 都 是 可 选择 的 。 如 果 不 传人 参数 ， 将 会 使 用 各 参数 的 默认 值 ， 参 数列 表 
如 下 : 


prompt 
Default is>. 默 认 值 为 >。 
stream 
Default is process.stdin. AEX process.stdin. 
eval 
Default is the async wrapper for eval.eval 的 默认 值 为 async。 
useGlobal 
默认 值 为 false， 新 建 一 个 语 境 而 不 是 使 用 全 局 对 象 。 
ignore Undefined 
默认 值 为 false。 不 要 忽略 undefined 的 返回 值 。 
当 我 开始 慢 慢 厌倦 REPL 在 无 返回 值 的 表达 式 输出 undefined 时 ， 我 决定 创建 自己 
的 REPL。 事 实 上 只 需要 两 行 代码 就 可 以 实现 〈 不 包括 注释 小 
repl = require ("repl"); 


// 设 置 1gnoreUndefined X true, BW REPL 
repl.start ("node via stdin> ", null, null, null, true); 


在 Node 中 运行 repl.js 文件 : 


node repl.js 


然后 就 可 以 像 使 用 REPL 内 建 版 本 一 样 使 用 自 定义 的 REPL， 除 了 自 定 义 的 提示 符 
以 及 不 会 在 变量 赋值 之 后 再 看 到 讨厌 的 undefined 之 外 ， 依 然 可 以 看 到 除了 
undefined 之 外 的 其 他 输出 。 


node via stdin> var ct = 0; 

node via stdin> ct++; 

0 

node via stdin> console.log(ct); 
1 

node via stdin> ++ct; 

2 

node via stdin> console.log(ct); 


2 
在 代码 中 我 希望 除了 提示 符 和 ignoreUndefined 以 外 都 使 用 默认 值 。 设 置 其 他 参数 
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为 null 会 使 Node 使 用 该 参数 的 默认 值 。 
可 以 用 月 定义 的 REPL 替换 eval 方法 。 唯 一 的 要 求 是 有 具体 的 格式 : 


function eval(cmd, callback) { 
callback(null, result); 
} 


stream 选项 比较 有 意思 ,可 以 运行 多 个 版 本 的 REPL ,从 标准 输入 ( 默认 ) 或 者 socket 
中 获取 输入 内 容 。Node.js 网 站 提供 的 REPL 文档 中 给 出 了 REPL 监听 TCP socket 
的 例子 ， 代 码 与 下 面 这 个 例子 类 似 : 


Var repl = require("repl"), 
net = require("net"); 
// 设 置 ignoreUndefined X true, AW REPL 
repl.start("node via stdin> ", null, null, null, true); 
net.createServer(function (socket) { 
repl.start("node via TCP socket> ", socket); 
}) -listen(8124); 


在 Node 中 运行 应 用 程序 的 时 候 会 看 到 标准 输入 提示 符 。 还 可 以 通过 TCP 进入 
REPL. 我 使 用 PuTTY 作为 Telnet 客户 端 来 登录 文 持 TCP 版 本 的 REPL, 某 种 程度 
上 来 说 是 可 行 的 。 我 必须 先 运行 .clear 清理 样式 ,但 在 尝试 使 用 下 划 线 表示 上 一 - 行 
命令 的 时 候 ，Node 无 法 解析 该 符 写 ， 如 图 2-1 所 示 。 








ep examp'es,burningbird.net - PuTTY o; E sa 
peee eiei ma ee F | 
Ciearing context... - 





mrm + a 23 f= a. pea p 
mode via TCE socker> undefined 


t 
i at 
| mode via TCP socket> [ay DPI | 
i | 
| mode via TCP socket> undefined | 
ncde via TCP socker> .iength; : 

iTypeErrcr: Cannct read preperty ‘liength' of undefined 

at repl:i:2Z 
at REPLS 
erver.eval {repi.33:82:21) 
ato repl.3s:290:20 | 
at REPLServer.evali {repl.is:2 

7:5} E 
at interface.<anonymous> (repiłi.ĵj3:182:1ł12) | 
at Intcerface.emit (events.j! 4% 
$:67:17) | 
at interface. onLine (readline. j38:162;10) : 
— 8 
at Interface. normalWri’ | 
te ({readline.33:236:15) E E 





at Socket.<ancnymous> (readiine.is:75:12) 














2-1 通过 TCP 的 PuTTY 和 REPL 并 不 一 样 
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同样 我 也 尝试 过 Windows 7 Telnet XP im, ik EAE, HATE Linux Telnet 客户 
en SE HRA E [a] 
你 可 能 预计 到 问题 在 于 Telnet 客户 端的 设置 。 然 而 ,我 并 没有 次 究 这 一 问题 。 因 为 
从 不 安全 的 Telnet Socket 运行 REPL 并 不 是 我 计划 要 做 的 事情 , 也 并 不 推荐 这 一 存 
在 安全 隐患 的 行为 。 就 像 在 客户 绵 代 人 码 中 使 用 eval() 一 样 ， 并 没有 破坏 或 者 泄露 客 
户 发 给 你 需要 运行 的 内 容 ， 但 是 结果 比 这 样 更 精 糕 。 
可 以 用 UNIX socket 通信 运行 REPL， 比 如 GNU Netcat: 
nc -U /tmp/node-repl-sock 
可 以 像 使 用 stdin 一 样 输入 命令 。 但 是 需要 了 解 的 是 ， 如 果 使 用 TCP 或 者 UNIX 
socket， 任 何 console.log 命令 都 会 在 server 站 打印 输出 ， 而 不 是 客户 端 。 
console.1log (someVariable);// 在 server 端 输 出 
我 想到 一 个 很 有 用 的 应 用 程序 , 创建 一 个 REPL 程序 , 可 以 预 加 载 模块 。 示 例 2-1 


的 应 用 中 ,在 REPL 局 动 之 后 ，http os 和 util 模块 被 加 载 并 赋值 给 当前 语 境 的 
对 应 属性 。 


示例 2-1 创建 可 以 预 加 载 模块 的 自 定义 REPL 


Var repl = require('repl'); 

var context = repl.start(">>", null, null, null, true) .context; 
// 预 加 载 模块 

context.http = require('http'); 

context.util = require('util'); 

context.os = require('os'); 


用 Node 运行 该 程序 ， 显 示 REPL 的 提示 符 ， 可 以 访问 之 前 加 载 的 那些 模块 
>>os.hostname () ; 
"einstein' 
>>util.log('message'); 


5 Feb 11:33:15 - message 
>> 


UREZ Linux 中 的 可 执行 程序 一 样 运行 REPL 程序 ,将 下 行 代码 加 入 应 用 程序 开头 : 
#!/usr/local/bin/node 
修改 文件 权限 为 可 执行 并 运行 : 


# chmod ut+x replcontext.js 
# ./replcontext.js 
>> 
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2.4 不 可 预计 的 意外 一 一 记得 经 常 保存 


Node 的 REPL 是 一 个 便捷 的 交互 式 工 具 , 可 以 使 开发 任务 变 得 简单 点 。REPL 不 仅 
可 以 在 引入 文件 之 前 对 JavaScript 进行 测试 ， 并 且 可 以 边 编 写 边 测试 直到 完成 时 保 
存 代 码 内 容 。 


REPL 男 一 个 有 用 的 特性 是 可 以 创建 自 定 义 的 REPL, 减少 无 用 的 undefined 输出 ， 
预 加 载 模块 以 及 修改 提示 符 或 者 eval 方法 等 。 


我 强烈 推荐 在 REPL 中 使 用 rlwrap， 可 以 路 session 浏览 历史 命令 。 这 一 特性 可 以 
节省 大 量 的 时 间 。 话 说 回来 ， 我 们 之 中 谁 不 喜欢 更 多 更 强大 的 编辑 特性 呢 ? 


当 你 进一步 探索 REPL 的 时 候 ， 要 记 住 本 章 的 一 个 重点 : 
EOE BLE, MEAT o 


如 果 你 花费 很 多 时 间 在 REPL 中 进行 开发 , 使 用 rlwrap 浏览 历史 命令 , 则 需要 频繁 
地 保存 代码 。 在 REPL 中 开发 与 其 他 编辑 环境 一 样 ， 意 外 的 发 生 不 可 预计 。 所 以 我 





一 再 重复 : 意外 的 发 生 不 可 避免 频繁 保存 为 上 策 。 
pd 提示 
REPL Æ Node 0.8 中 有 较 大 修改 ， 输 入 内 建 的 模块 名 称 ， 比 如 人 ， 就 
可 以 加 载 该 模块 了 。 其 他 一 些 改 进 标注 在 Node.js 官网 提供 的 新 的 
REPL 文档 中 。 
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第 3 章 


Node 核心 库 


在 第 1 章 中 ， 我 们 实现 了 一 个 能 够 在 Node 中 运行 的 经 典 的 Hello World 程序 ， 
尽管 这 是 我 们 实现 的 第 一 个 Node 程序 ， 但 它 依 然 使 用 到 了 Node 核心 库 中 的 多 
个 模块 。Node 核心 库 包 含 了 大 量 API， 这 些 API 为 我 们 提供 了 构建 Node 应 用 
程序 时 所 需要 的 功能 模块 。 


本 章 将 涉及 更 多 Node 核心 库 系 统 的 细节 知识 。 但 是 我 们 并 不 想 提 供 一 份 详尽 细致 
的 核心 库 规范 综述 ， 因 为 它 的 确 太 过 于 庞大 并 且 不 时 会 有 更 新 。 相 反 ， 我 们 将 着 重 
对 和 核心 库 中 的 一 些 关 键 元 素 进行 介绍 , 因为 在 后 续 革 市 我 们 将 经 党 使 用 到 或 提 友 
它们 ,并且 其 中 有 些 也 值得 我 们 深入 探讨 。 


本 草 所 涉及 的 主题 包括 : 

e Node 全 局 对 象 : 例如 global, process 和 buffer 

。 ”定时 需 方 法 ， 如 setTimeout 

e socket 和 stream 模块 功能 综述 

e Utilities 对 象 ， 特 别 是 与 Node 继承 特性 相关 的 方法 
e EventEmitter 对 象 及 事件 (event) 


提示 
当前 最 新 Node.js 稳定 版 的 文档 可 参见 http://nodejs.or/api/。 
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3.1 全 局 对 象 : global, process 和 Buffer 


这 里 有 几 种 对 象 总 是 可 以 被 所 有 Node 应 用 程序 所 访问 到 ， 即 使 用 户 没有 明确 的 在 
应 用 程序 中 包含 这 些 对 象 的 模块 。 在 Node.js 站 点 上 ， 这 种 对 象 被 统一 归 类 并 放 在 
globals 标签 下 。 


我 们 已 经 使 用 过 一 种 全 局 对 象 require 来 将 其 他 模块 包含 进 应 用 程序 。 同 样 也 大 量 
使 用 了 另 一 个 全 局 对 象 console 来 输出 信息 到 控制 台 merci Node 的 
整体 框架 来 说 非常 重要 , 但 我 们 并 没有 必要 立即 了 解 或 学 会 使 用 所 有 对 象 。 只 是 其 
中 一 些 关 键 对 象 还 是 值得 我 们 仔细 看 看 , 因为 它们 可 以 帮助 我 们 从 某 些 关键 方面 理 
解 Node 是 如 何 工 作 的 。 

本 节 我 们 将 着 重 探索 以 下 内 容 : 

e = global 对象， 也 是 Node 的 全 局 命名 空间 ， 


e process 对象， 它 提供 了 一 些 关 键 功能 ， 例 如 对 三 种 标准 VO 流 的 封装 ， 以 及 将 
[Fl R FE BRN FE Il Dead BE 


e Buffer 类 ， 它 提供 了 存储 和 操作 原始 数据 的 功能 ， 同 样 它 也 是 全 局 可 见 的 ，; 
o 子 进 程 ; 
e。 用 于 域名 解析 和 URL 处 理 的 模块 。 


3.1.1 global 


global 是 Node 的 全 局 命名 空间 对 象 , 从 某 些 方面 来 说 , 它 与 浏览 器 环境 中 的 window 
对 象 是 相似 的 , 都 为 用 户 提 供 全 局 属性 和 全 局 方法 的 访问 能 力 , 并 且 用 户 也 不 需要 
显 式 使 用 global 命名 空间 。 


在 REPL 里 面 ， 你 可 以 使 用 下 面 这 条 命令 将 global 对 象 输出 到 console 里 面 : 
> console.log(global) 


输出 信息 中 包含 了 其 他 全 局 对 象 的 接口 ， 以 及 大 量 当 前 系统 的 大 量 环境 信息 


之 前 提 到 global SMa FN window 对 象 是 相似 的 ,它们 除了 在 一 些 方法 和 属 
性 有 效 性 上 不 一 致 外 , 还 有 一 个 关键 不 同 是 : DAE PY window 对 象 是 一 个 真 
正 全 局 的 对 象 。 如 果 你 在 客户 端 JavaScript 中 定义 一 个 全 局 变量 ， 它 将 能 够 被 
Web 页 面 以 及 每 一 个 独立 的 库 访 问 到 。 然 而 , 如 果 在 Node 模块 中 创建 一 个 顶层 
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变量 ( 在 哺 数 之 外 的 变量 )， 它 仅仅 在 该 模块 中 是 全 局 的 ， 而 在 其 他 模块 中 是 不 
可 见 的 。 


当 你 在 REPL 里 面 定 义 一 个 全 局 变量 时 , 你 可 以 观察 到 global 对 象 实际 所 发 生 的 事情 ; 


> Var test = "This really isn't global, as we know global"; 
查看 global WANK: 


> console.log(global); 


你 可 以 看 到 定义 的 变量 已 经 变 为 一 个 global 对 象 的 属性 , 并 且 出 现在 输出 信息 
的 底部 。 另 一 个 有 趣 的 测试 是 将 global 对 象 赋值 给 一 个 变量 , 但 是 这 个 变量 不 
使 用 var 来 定义 : 


gl = global; 


global 对 象 将 被 输出 到 控制 台中 ,同样 在 输出 信息 底部 看 到 gl ZEN ‘circular refernce’ : 
> gl = global; 


gl: [Circular], 
_: [Circular] } 


其 他 全 局 对 象 (包括 require 对 象 ) 以 及 全 局 方法 都 包含 在 global 对 象 接 口中 。 


当 Node 开发 人 员 谈 及 context 时 ， 一 般 是 指 global 对 象 。 在 第 2 章 示 例 2-1 的 代码 
中 ， 自 定义 的 REPL 对 象 被 创建 时 ， 使 用 到 了 context WA. context 对 象 是 一 个 全 
局 对 象 。 当 应 用 程序 创建 一 个 自 定义 REPL 对 象 时 ， 还 会 生成 一 个 新 的 context 对 
象 ， 并 且 这 个 context 对 象 拥 有 目 己 的 global 对 象 。 如 果 你 在 创建 REPL 对 象 时 将 
true 值 传递 给 useGlobal 参数 的 话 ， 默 认 行 为 (新建 global WH) 将 被 覆盖 ， 当 前 
的 global 对 象 将 被 使 用 来 创建 一 个 REPL WH. 


模块 存在 于 自己 的 命名 空间 ， 这 意味 着 ， 如 果 你 在 一 个 模块 中 定义 一 个 顶层 变量 ， 
它 是 不 能 被 其 他 模块 使 用 的 。 更 重要 的 是 , 这 意味 着 , 只 有 那些 被 模块 显 式 导出 的 
部 分 才能 被 引用 该 模块 的 应 用 程序 所 使 用 。 事实 上 , 你 不 能 在 应 用 程序 或 其 他 模块 
中 访问 另 一 个 模块 的 顶层 变量 ， 即 使 你 刻意 这 样 做 。 


为 了 说 明 这 一 点 ,下 面 的 代码 实现 了 一 个 非常 简单 的 模块 , 模块 中 定义 了 一 个 名 为 
globalValue 的 顶层 变量 ， 以 及 对 该 变量 进行 设置 和 读 取 的 晒 数 。 在 读 取 陋 数 中 , 我 
们 使 用 console.log 方法 调用 将 全 局 对 象 的 内 容 打 印 出 来 。 

var globalValue; 

exports.setGlobal = function(val) { 


globalValue = val; 
bi 
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exports.returnGlobal = function() { 
console.log(global); 
return globalValue; 
}; 
我 们 可 能 希望 在 打印 出 全 局 对 象 内 容 时 ， 能 看 到 globalValue 变量 ， 包 括 我 们 在 程 
序 中 为 其 所 设置 的 值 。 但 实际 并 不 如 此 。 


启动 REPL 并 通过 require 加 载 我 们 编写 的 新 模块 : 
> Var modl = require('./modl.js'); 


调用 模块 提供 的 设置 函数 为 模块 中 的 顶层 变量 globalValue 赋值 ， 然 后 再 调用 读 取 
明 数 将 值 取 回来 : 


> modl.setGlobal (34); 
> var val = modl.returnGlobal (); 


在 返回 global Value 变量 值 之 前 , console.log 方法 会 先 输出 global 对 象 的 内 容 。 我 们 
可 以 看 到 ， 在 输出 信息 的 最 后 部 分 包含 了 被 引用 模块 的 信息 ,但 val 变量 的 值 是 不 
确定 的 ， 因 为 该 变量 尚未 设置 。 此 外 ,输出 信息 中 并 不 包 仿 任何 关于 模块 项 级 变量 
globalValue 的 信息 : 

modl: { setGlobal: [Function], returnGlobal: [Function] }, 


_: undefined, 
val: undefined } 


如 果 我 们 再 次 运行 命令 ， 可 以 看 到 应 用 程序 变量 val 被 设置 了 新 值 ， 但 我 们 仍然 不 
能 看 到 globalValue: 
modi: { setGlobal: [Function], returnGlobal: [Function] }, 


_: undefined, 
val: 34 } 


调用 模块 对 外 提供 的 方法 是 访问 模块 内 数据 的 唯一 途径 。 对 于 JavaScript 开发 人 员 
来 说 , KERA, 由 于 不 小 心 使 用 了 重复 的 全 局 变量 名 称 而 引起 的 数据 冲突 问题 将 
会 大 大 减少 。 


3.1.2 process 


每 个 Node 应 用 程序 都 是 一 个 process 对 象 实 例 ， 正 因为 如 此 ， 应 用 程序 自然 就 能 
直接 使 用 某 些 内 建 于 process 对 象 的 功能 。 


process 对 象 中 的 许多 方法 和 属性 能 提供 关于 应 用 程序 身份 标识 和 当前 运行 
环境 的 信息 。 调 用 process.execPath 方法 可 以 返回 当前 Node 应 用 程序 的 执行 
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路 径 process.version 提供 了 Node 版 本 信息 process.platform 提供 服务 器 平 


公 f= 
Gg IA u È 


console.log(process.execPath) ; 
console.log(process.version) ; 
console.log(process.platform) ; 


在 我 的 机 右上 运行 代码 ， 返 回 如 下 信息 : 


/usr/local/bin/node 
v0.6.9 
linux 


process 对 象 对 一 些 标准 输入 输出 流 也 进行 了 封 次 ， 包 括 标 准 输入 stdin ， 标 准 输出 
stdout 和 标准 错误 输出 stderr. stdin 和 stdout 支持 异步 操作 ， 前 者 可 读 , 后 者 可 写 。 
然而 ， 要 注意 的 是 stderr 是 一 个 同步 可 阻塞 流 。 


为 了 演示 如 何 从 stdin 和 stdout 读 取 和 写 入 数据 , 示例 3-1 中 的 Node 应 用 程序 监听 
标准 输入 的 数据 ， 然 后 再 将 数据 复制 到 标准 输出 。stdin 流 默认 情况 下 是 不 允许 直 
接 操作 的 ， 所 以 在 发 送 数据 之 前 ， 我 们 必须 先 调用 resume. 


示例 3-1 使 用 stdin 和 stdout 来 读 取 和 写 入 数据 


process.stdin.resume(); 


process.stdin.on('data’, function (chunk) { 
process.stdout.write('data: ' + chunk); 


}); 
使 用 Node 运行 该 示例 程序 ， 然 后 在 终端 上 用 键盘 输入 信息 。 每 次 你 输入 信息 并 按 
回 车 键 后 ， 这 些 信息 都 会 被 回 显 。 
process 对 象 中 男 一 个 常用 的 方法 是 memoryUsage, 通过 它 我 们 可 以 查询 当前 Node 
应 用 程序 的 内 存 使 用 量 。 这 对 于 应 用 程序 的 性 能 调整 是 非常 有 用 的 , 或 许 也 能 满足 
那些 对 程序 有 好 奇 心 的 人 。 调 用 该 晒 数 后 的 输出 示例 如 下 : 

{ rss: 7450624,heapTotal: 2783520,heapUsed: 1375720} 

其 中 heapTotal 和 heapUsed 属性 指示 了 V8 引擎 的 内 存 使 用 情况 。 
最 后 ， 我 还 想 提 及 下 process 对 象 的 nextTick 方法 。 这 个 方法 可 以 将 一 个 回调 


KRGE] Node 程序 的 事件 循环 机 制 中 ， 并 在 下 一 个 事件 循环 发 生 时 调用 该 
PKI Š o 


如 果 由 于 某 种 原因 ， 你 想 延 迟 并 且 异 步 的 执行 某 个 函数 调用 ， 那 么 你 可 以 使 用 
process.nextTick。 一 个 很 好 的 例子 是 ， 你 需要 创建 一 个 新 的 因数 ， 该 柄 数 有 一 个 回 
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Hel PRE A LS, 而 且 你 期 望 该 回调 吨 数 能 真正 的 被 异步 执行 。 下 面 的 代码 是 一 
个 演示 : 
function asynchFunction = function (data, callback) { 
process.nextTick(function() { 
callback (val); 


Ky? 
1G 


MRR Bl eva AIL val ea, 行为 将 是 同步 的 。 而 在 上 面 代 码 中 , 对 回调 函数 的 调 
用 会 被 延迟 到 下 一 个 事件 循环 ， 而 不 是 被 立即 调用 。 


虽然 你 也 可 以 使 用 setTimeout 方法 并 传 入 一 个 (0 ) ERD AY METS KIA FI EA AY, 
而 不 有 用 process.nextTick 方法 ， 例 如 : 
setTimeout (function() { 


callback(val); 
by Ol% 


SK itil, setTimeout 方法 并 不 像 process.nextTick 方法 那样 高 效 。 当 对 它们 进行 对 比 测 
试 时 ，process.nextTick 的 调用 速度 远 远 快 于 使 用 setTimeout 方法 。 另 外 ， 当 你 的 应 
用 程序 需要 执行 一 些 复杂 的 计算 或 者 其 他 费时 的 操作 时 ， 你 也 可 以 考虑 使 用 
process.nextTick 方法 。 首 先 你 需要 将 耗 时 的 处 理 过 程 打 散 并 分 解 成 多 个 部 分 , 每 个 
部 分 分 别 通过 process.nextTick 调用 ,最 终 使 得 应 用 程序 可 以 对 其 他 请 求 进 行 处 理 ， 
而 无 需 等 竺 耗 时 计算 过 程 完成 。 

当然 , 与 此 相反 的 是 , 你 不 能 打 散 一 个 必须 按 序 执行 的 处 理 过 程 , 否则 你 最 终 可 能 
会 得 到 无 法 预料 的 处 理 结果 。 


3.1.3 Buffer 

Buffer 是 Node 中 的 另 一 个 全 局 对 象 ， 是 用 于 处 理 二 进 制 数据 的 一 种 方式 。 在 本 
章 后 半 部 分 (参考 3.3 节 )， 我 们 将 会 了 解 这 样 一 个 事实 : 即 流 处 理 往往 采用 的 
是 二 进 制 数 据 ， 而 非 字 符 串 。 为 了 将 二 进 制 数据 转换 为 字符 串 ， 需要 调用 流 套 
接 字 的 setEncoding 因数 来 改变 当前 使 用 的 数据 编码 方式 。 

作为 示例 ， 你 可 以 使 用 如 下 代码 来 创建 一 个 新 的 buffer 对 象 : 


var buf = new Buffer(string); 


若 需 要 将 一 个 字符 串 保存 在 buffer 中 时 , 你 可 以 通过 传人 第 二 个 可 选 参数 来 设置 对 
该 字符 串 的 编码 方式 。 支 持 的 编码 方式 包括 : 
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ascii 
七 位 ASCII. 
utf8 
多 字 节 编码 的 Unicode 字符 。 
usc2 
两 字 节 ，little endian 方式 编码 的 Unicode 字符 。 
base64 
Base64 编码 。 
hex 
每 个 字 节 编码 为 两 个 十 六 进 制 字符 。 
你 也 可 以 将 字符 串 写 人 到 一 个 现 有 的 buffer 对 象 中 , 并 指定 该 写 人 操作 的 偏 移 ， 数 


buf.write (string); // 写 入 的 默认 偏 移 为 0， 默认 数据 长 度 为 
buffer.length - offset， 编 码 默认 采用 utf8 

套 接 字 接口 之 间 传 递 数 据 时 ， 会 默认 将 数据 包 闭 在 buffer 对 象 中 (采用 二 进 制 
数据 格式 )。 如 宁 想 要 发 送 字 符 串 数据 ， 你 可 以 直接 调用 套 接 字 接口 上 的 
setEncoding 曙 数 ， 或 者 在 将 数据 写 人 套 接 字 接口 时 ， 使 用 参数 指定 编码 方式 。 
默认 情况 下 ,TCP( 传输 控制 协议 ) 的 socket.write 方法 会 将 第 二 个 参数 设 为 utf8， 
但 对 于 通过 TCP 服务 端 中 connectionListener 回调 函数 返回 的 套 接 字 , 其 发 送 的 
数据 是 一 个 buffer 对 象 ， 而 非 字 符 串 。 


3.2 RS. setTimeout、clearTimeout、setlnterval 
和 clearlnterval 
在 客户 闪 JavaScript 编程 中 ， 和 定时 天 功能 由 全 局 窗口 对 象 windows 提供 。 虽 然 


JavaScript 本 身 并 不 提供 定时 天 功 能 ， 但 却 在 JavaScript 相关 的 开发 中 被 广泛 使 用 ， 
因而 Node 将 其 也 纳入 了 核心 API 中 。 


Node 对 定时 需 功 能 所 提供 的 操作 与 浏览 右 提 供 的 操作 相似 。 事 实 上 ，Node 与 
Chrome 中 的 定时 需 果 数 接口 完全 一 致 ， 因 为 Node 就 是 基于 Chrome AY V8 
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JavaScript 引擎 工作 的 。 
调用 Node 的 setTimeout 困 数 时 ， 需 要 传人 一 个 回调 困 数 作为 第 一 个 参数 ， 第 二 个 
参数 为 延迟 时 间 (以 训 秒 为 单位 )， 以 及 一 个 可 选 参 数列 表 : 


// timer to open file and read contents to HTTP response object 
function on OpenAndReadFile(filename, res) { 


console.log('opening ' + filename); 
// open and read in file contents 
fs.readFile(filename, ‘utf8', function(err, data) { 
if (err) 
res.write('Could not find or open file for reading\n'); 
else { 
res.write(data) ; 


// reponse is done 
res.end(); 


setTimeout(openAndReadFile, 2000, filename, res); 


Æ ERREP, Æ setTimeout PRAT AKA 2000 2H IA, lal dal pK A 
on_OpenAndReadFile 会 被 调用 ,打开 一 个 文件 并 读 取 内 容 , 然后 将 文件 内 容 作 
为 HTTP 响应 数据 返回 。 


警告 
<= iE 4a Node 文档 所 严谨 标注 的 一 样 ,无 法 保证 回调 函数 能 够 在 绝对 准 

确 的 毫秒 级 延 退 后 被 调用 。 在 浏览 器 环境 中 使 用 setTimeout 也 存在 
同样 问题 ， 因 为 我 们 没有 对 运行 环境 的 绝对 控制 权 ， 许 多 因素 都 可 
能 对 定时 器 的 计时 准确 度 有 略微 影响 。 

PKŠ clearTimeout 可 以 清除 通过 setTimeout 预 设 的 定时 需 。 如 果 你 有 重复 计时 的 需求 , 可 

以 使 用 setInterval 本 数 来 设置 时 间 间 隔 ， 在 每 隔 n 毫秒 (n 是 传递 给 吨 数 的 第 二 个 参数 ) 

后 调用 一 个 回调 函数 (第 一 个 参数 )。 陨 数 clearInterval 可 以 用 来 清除 时 间 间 隅 设置 。 


3.3 Servers. Streams 和 Sockets 


许多 Node 核心 API 需要 通过 创建 服务 的 方式 来 监听 特定 类 型 的 通信 。 在 第 1 章 
的 示例 中 ， 我 们 使 用 HTTP 模块 创建 了 一 个 HTTP Web 服务 器 。 还 有 其 他 方法 可 以 
建立 TCP 服务 器 ，TLS ( 传输 层 安全 ) 服务 器 和 UDP ( 用 户 数据 报 协议 ) /数据 报 套 
接 字 。 我 会 在 第 15 章 介 绍 TLS ， 但 在 本 节 中 ， 我 要 为 大 家 介绍 Node 核心 库 对 TCP 
和 UDP 的 支持 。 不 过 首先 还 是 需要 对 在 本 节 中 使 用 的 术语 做 一 个 简要 的 介绍 。 


套 接 字 (socket) 是 指 通信 端点 ; 网 络 套 接 字 (network socket ) 指 的 是 工作 在 
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同一 个 网 络 中 ， 在 两 台 不 同 计算 机 上 运行 的 应 用 程序 之 间 的 通信 端点 。 套 接 
字 之 则 传送 的 数据 被 称 为 流 ( stream )。 我 们 可 以 通过 一 个 buffer WARP 
传送 二 进 制 数据 , 或 通过 Unicode 编码 方式 来 传送 一 个 字符 串 。 两 种 类 型 的 数 
据 最 终 均 会 被 包装 为 数据 包 ( packets ) 进行 传送 ， 部 分 数据 会 被 分 拆 成 特定 
大 小 的 包 。 套 接 字 可 以 通过 发 送 一 种 特殊 的 数据 包 FIN (完成 数据 包 ) 来 表明 本 次 
传输 已 经 完成 。 通 信 的 可 管理 性 以 及 流 的 可 靠 性 ， 取 决 于 创建 的 套 接 字 类 型 。 


3.3.1 TCP Sockets 和 Servers 


我 们 可 以 使 用 Node 中 的 Net 模块 来 创建 一 个 基本 的 TCP 服务 器 和 客户 端 。 大 多 数 
的 互联 网 应 用 都 是 基于 TCP 的 ， 如 Web 服务 和 电子 邮件 ， 它 是 一 种 能 在 客户 端 和 
服务 带 套 接 字 之 间 提 供 可 靠 传输 数据 的 方式 。 


在 第 1 章 示 例 1-1 F, 我 们 创建 了 HTTP 服务 器 并 传人 一 个 requestListener 回调 
也 数 来 处 理 用 户 请 求 。 但 创建 TCP 服务 器 有 些许 不 同 ,传人 的 回调 函数 只 有 一 
个 参数 ， 这 个 参数 是 一 个 套 接 字 对 象 的 实例 ， 代 表 连 接 到 该 TCP 服务 器 的 客户 
iE BE « 

在 示例 3-2 的 代码 中 ， 我 们 创建 了 一 个 TCP 服务 端 。 一 旦 与 客户 端 相 连接 的 服务 
wae BEE, 它 就 会 持续 监听 两 个 事件 : 一 个 表示 是 否 有 来 自 客户 端的 数据 
需要 接收 ， 另 一 个 表示 客户 端 连接 是 否 断 开 或 关闭 。 


示例 3-2 一 个 简单 的 TCP 服务 器 ， 并 在 端口 8124 上 监听 客户 端 连接 请 求 
var net = require('net'); 


var server = net.createServer(function(conn) { 
console. log('connected' ); 


conn.on('data', function (data) { 
console.log(data + ' from ' + conn.remoteAddress + ' ' + 


conn.remotePort) ; 
conn.write('Repeating: ' + data); 


conn.on('close', function() 
console.log('client closed connection’ ); 


}).listen(8124); 


console. log('listening on port 8124'); 


createServer 方法 有 一 个 可 选 参数 allowHalfOpen。 如 果 将 该 参数 设置 为 tue， 那 么 
当 套 接 字 从 客户 端 接 收 到 一 个 FIN 包 后 ， 它 不 会 发 送 另 一 个 FIN 作为 回应 。 这 样 
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做 可 使 得 套 接 字 接口 始终 打开 并 且 可 写 〈 当然 不 可 读 )。 如 果 想 关闭 套 接 字 ， 你 需 
要 明确 地 使 用 end 方法 。 默 认 情 况 下 ，allowHalfOpen 是 false 的 。 


注意 回调 冰 数 是 如 何 通过 on 方法 被 绑 定 到 两 个 不 同 的 事件 上 的 。 在 Node H, 许 
多 可 以 产生 事件 的 对 象 都 文 持 通 过 on TTR ABE VET A WITTE TER 
为 事件 名 称 ， 第 二 个 参数 为 事件 处 理 顺 数 。 

提示 

Node 中 有 一 个 较为 特殊 的 对 象 EventEmitter， 所 有 继承 自 它 的 对 象 都 
会 提供 on 方法 ， 在 本 章 的 后 面 会 继续 讨论 该 对 象 。 





创建 TCP 客户 端 与 创建 TCP 服务 端 一 样 简 单 ， 如 示例 3-3 中 所 示 。 在 客户 端 套 接 
字 接 口上 调用 setEncoding 方法 来 改变 对 接收 数据 的 编码 处 理 方式 。 正 如 我 们 在 
“Buffer” 一 市 所 提 到 的 ， 数 据 被 当 作 buffer 对 和 象 传送 ， 但 我 们 可 以 通过 调用 
setEncoding 方法 ,将 收 到 的 数据 转换 为 UTF8 字符 串 后 处 理 它 。 套 接 字 接 口 的 write 
方法 是 用 来 发 送 数据 的 。 代 码 中 我 们 同样 监听 了 两 个 事件 : 数据 接收 事件 和 服务 端 
连接 关闭 事件 ， 以 便 在 服务 闪 关 闭 时 做 一 些 收尾 处 理 。 


示例 3-3 使 用 TCP 客户 端 套 接 字 发 送 数据 给 TCP 服务 端 


var net = require('‘net'); 


var client = new net.Socket(); 
client.setEncoding('utf8'); 


// connect to server 

client.connect ('8124','localhost', function () { 
console.log('connected to server’); 
client.write('Who needs a browser to communicate?’ ); 


})3 


// prepare for input from terminal 
process. stdin.resume(); 


// when receive data, send to server 

process.stdin.on('data', function (data) { 
client .write(data) ; 

})3 


// when receive data back, print to console 
client.on('data',function(data) { 
console. log(data) ; 


// when server closed 
client.on('close',function() { 

console.log( ‘connection is closed’); 
})3 
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当 我 们 在 终端 里 面 输入 信息 并 按 下 回 车 键 后 , 输入 的 内 容 将 在 服务 端 和 客户 端 套 接 
字 接 口 之 间 传 送 。 客户 端 应 用 程序 会 将 你 刚才 输入 的 字符 串 发 送 给 服务 端 ,， 而 服务 
端 会 将 收 到 的 内 容 输出 到 控制 台 。 同 时 服务 端 会 将 同样 的 内 容 青 次 发 送 回 客户 症 ， 
这 样 客户 端 反 过 来 又 将 内 容 输 出 到 控制 台 。 通过 读 取 与 客户 并 相 连 的 套 接 字 接口 上 
的 remoteAddress 和 remotePort 属性 , 服务 端 还 能 将 客户 端 使 用 的 IP 地 址 和 端口 打 
印 出 来 。 下 面 是 客户 端 与 服务 端 通信 时 的 控制 台 输 出 示例 ( 出 于 安全 考虑 IP 地 址 
已 被 修改 ): 

Hey, hey, hey, hey-now. 

from #ipaddress 57251 

Don't be mean, we don't have to be mean. 

from #ipaddress 57251 i 

Cuz remember, no matter where you go, 

from #ipaddress 57251 


there you are. 
from #ipaddress 57251 


客户 端 和 服务 端 之 间 的 TCP 连接 会 一 直 保 持 ， 直 到 你 通过 使 用 Ctrl+C 关闭 任 
何 一 端 。 而 未 关闭 的 另外 一 端 接 会 接收 到 close 事件 并 在 控制 台 输 出 关闭 提示 
信息 。 由 于 所 有 操作 都 是 异步 进行 的 , 服务 端 可 以 支持 来 日 多 个 客户 症 的 多 个 
连接 。 


正如 之 前 提 到 的 , 今天 我 们 使 用 的 大 部 分 互联 网 应 用 功能 , 其 底层 传输 机 制 都 采用 
了 TCP, HTTP 就 是 一 个 例子 ， 下 一 小 节 我 们 会 对 它 有 更 多 了 解 。 


3.3.2 HTTP 


在 第 1 章 中 ， 我们 曾经 使 用 HTTP 模块 的 createServer 方法 创建 HTTP 服务 器 ， 并 
传人 一 个 回调 函数 作为 requestListener， 以 便 异步 处 理 收 到 的 HTTP 请 求 。 


在 网 络 体 系 结 构 中 , TCP 是 运输 层 而 HTTP 是 应 用 层 。 如 果 留 意 下 Node 应 用 程序 所 
包含 的 模块 的 话 ， 你 会 看 到 ， 当 创建 一 个 HTTP 服务 器 时 ， 我 们 实际 上 已 经 从 
net.Server 模块 继承 了 很 多 功能 ， 而 net.Server 则 实现 了 对 TCP 的 封装 。 


对 于 HTTP 服务 器 来 说 ，requestListener WREEF, M http.ServerRequest 对 应 
于 可 读 流 ，http.ServerResponse 对 应 于 可 写 流 。HTTP 之 所 以 增加 了 男 一 个 层面 上 
的 技术 复杂 性 , 是 因为 它 需 要 文 持 分 块 传输 编码 。 分 块 传输 编码 可 以 在 响应 数据 未 
完全 生成 时 进行 数据 传输 , 注意 此 时 还 无 法 确定 啊 应 信息 的 具体 大 小 。 如 有 果 分 块 中 
所 包含 信息 的 长 度 为 0， 则 表示 响应 信息 的 结束 。 当 你 需要 将 大 型 数据 库 的 查询 结 
果 输 出 到 一 个 HTML 表格 时 ， 这 种 编码 方式 将 非常 有 用 ， 因 为 在 你 收 到 所 有 查询 
结果 之 前 ， 就 可 以 将 数据 写 人 响应 信息 进行 输出 了 。 
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提示 
更 多 关于 流 的 说 明 会 在 “Stream、Pipes 和 Readline” 一 节 中 进行 说 明 。 





本 章 前 面 的 TCP 示例 ， 以 及 第 1 章 的 HTTP 示例 ， 都 是 工作 在 网 络 套 接 字 接 口上 
的 。 然 而 ， 所 有 的 server/socket 模块 除了 可 以 连接 并 工作 在 特定 的 网 络 端口 上 ， 还 
文 持 连接 到 Unix 套 接 字 。 与 网 络 套 接 字 不 同 ，Unix 或 IPC ( 进程 间 通 信 ) 套 接 字 
文 持 主 要 用 来 支持 同一 系统 内 的 进程 间 通 信 。 


为 了 说 明基 于 Unix 套 接 字 的 通信 ， 我 重用 了 示例 1-3 中 的 代码 ， 但 并 非 绑 定 到 一 个 
网 络 病 口 ， 而 是 绑 定 到 了 一 个 Unix 套 接 字 上 ， 如 示例 3-4 代码 所 示 。 示 例 程序 还 使 
用 到 了 readFileSyne 函数 ， 它 是 一 个 同步 版 本 的 文件 打开 和 内 容 读 取 的 吨 数 。 


示例 3-4 基于 Unix 套 接 字 的 HTTP 服务 器 


// create server 

// and callback function 
var http = require('‘http'); 
var fs = require('fs'); 


http.createServer(function (req, res) { 


var query = require('url').parse(req.url).query; 
console. log(query) ; 
file = require('querystring' ).parse(query). file; 


// content header 
res.writeHead(200, {'Content-Type': ‘text/plain’ }); 


// increment global, write to client 
for (var i = 0; i<100; i++) 
res.write(i + '\n'); 


// open and read in file contents 

var data = fs.readFileSync(file, ‘utf8'); 

res.write(data) ; 

res.end(); 
}).listen('/tmp/node-server-sock' ); 


通过 修改 Node.js 主 站 文档 中 提供 的 有 关 http.request 对 象 的 示例 代码 , 我 们 得 到 了 
用 于 测试 的 客户 端 人 代码。 注意 http.request 对 象 在 默认 情况 下 会 使 用 套 接 字 池 
http.globalAgent。 而 该 池 黑 认可 以 保存 最 多 五 个 套 接 字 接 口 ， 不 过 可 以 通过 改变 
agent.maxSockets 值 来 调整 它 。 


在 示例 3-5 的 代码 中 ， 客户 剖 会 接收 从 服务 冀 返 回 的 分 块 数据 ， 并 输出 到 终 症 。 为 
外 客户 端 还 通过 往 请 求 中 放 人 一些 重 复数 据 来 触发 服务 融 半 的 啊 应 。 


示例 3-5 连接 到 Unix 套 接 字 并 输出 接收 的 数据 


var http = require( http ) ; 


var options = { 
method: ‘GET’, 
socketPath: '/tmp/node-server-sock’, 
path: "/?file=main.txt" 


3 


var req = http.request(options, function(res) { 
console. log('STATUS: ”+ res.statusCode); 
console.log('HEADERS: ' + JSON.stringify(res.headers)); 
res.setEncoding('utf8'); 
res.on('data', function (chunk) { 
console.log('chunk o\' data: ' + chunk); 


3 


}); 


req.on('error', function(e) { 
console.log('problem with request: ' + e.message); 


3 


// write data to request body 
req.write('data\n'); 
req.write('data\n'); 
req.end(); 


HAYS Fy ET AE SCP SEE, AE DS A SC ASE PRP HE HE EE KA A 
被 调用 ， 而 无 法 输出 文件 内 容 到 客户 端 。 
在 我 们 即将 结束 对 HTTP 模块 的 说 明 前 ， 你 应 当 留 意 到 Node HTTP 服务 如 并 没有 
整合 Apache 或 其 他 Web 服务 。 举 例 来 说 ， 如 果 你 希望 网 站 有 和 密码 保护 功能 ， 你 可 
以 使 用 Apache 来 弹出 一 个 窗口 询问 用 户 名 和 密码, 但 Node HTTP 服务 器 不 会 。 所 
以 你 将 不 得 不 自己 编码 来 实现 它 。 

ee 
à 第 15 章 介 绍 支持 SSL 版 本 的 HTTP 4e HTTPS, 以 及 Crypto 42 TLS/SSL. 





3.3.3 UDP 数据 报 套 接 字 

TCP 需要 在 通信 的 两 个 端点 之 间 建 立 一 个 专用 连接 。 而 UDP 是 无 连接 协议 ， 这 意 
味 着 两 个 端点 之 间 的 连接 是 没有 保证 的 。 出 于 这 个 原因 ， 相 比 TCP 来 说 UDP 是 不 
可 靠 和 不 健全 的 。 不 过 另 一 方面 ,UDP th TCP E, 这 使 得 它 更 适合 于 实时 通信 ， 
比如 应 用 在 VoIP ( 互联 网 语音 传输 协议 ) 中 ; 如 果 使 用 TCP， 由 于 必须 建立 连接 
从 而 会 对 信号 质量 产生 不 利 影响 。 


Node 核心 库 支 持 这 两 种 类 型 的 套 接 字 。 在 过 去 的 几 节 中 ， 我 们 对 TCP 功能 进行 了 
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说 明 。 现 在 ， 我 们 来 了 解 下 Node 对 UDP 的 支持 。 
UDP 模块 的 标识 符 是 "dgram " : 


require ('dgram'); 


要 创建 一 个 UDP 套 接 字 ， 可 以 使 用 createSocket 方法 并 传人 套 接 字 类 型 参数 udp4 
或 udp6。 你 同样 也 可 以 传递 一 个 回调 函数 用 于 监听 事件 。 与 使 用 TCP 发 送 消息 不 
同 的 是 ， 使 用 UDP 发 送 消 息 时 必须 使 用 buffer， 而 不 能 是 字符 串 。 


示例 3-6 是 一 个 UDP 客户 端 示例 代码 。 我们 通过 process.stdin 得 到 输入 数据 , 然后 
将 其 通过 UDP 套 接 字 发 送出 去 。 请 注意 ， 我 们 没有 设置 字符 串 的 编码 方式 ， 因 为 
UDP 套 接 字 只 接受 buffer 对 象 ， 而 从 process.stdin 获得 的 数据 已 经 被 包装 在 一 个 
buffer 对 象 中 。 但 我 们 必须 调用 buffer 对 象 的 toString 方法 将 缓冲 区 的 数据 转换 为 
一 个 字符 串 , 以便 我 们 将 缓冲 区 的 数据 编码 为 可 读 信 息 并 通过 console.log 方法 输出 
到 终端 上 。 


示例 3-6 UDP 客户 问 ， 将 输入 到 终端 的 信息 通过 UDP 套 接 字 发 送出 去 
var dgram = Tequire( dgram ); 
var client = dgram.createSocket("udp4") ; 


// prepare for input from terminal 
process.stdin.resume() ; 


process.stdin.on('data', function (data) { 
console. log(data.toString('utf8')); 
client.send(data, 0, data.length, 8124, "“examples.burningbird.net", 
function (err, bytes) { 


if (err) 
console.log('error: ' + err); 
else 
console.log('successful' ); 
}); 
})3 


示例 3-7 是 UDP 服务 端 代 码 ， 比 客户 端 代 码 更 简单 。 服 务 端 应 用 程序 创建 了 套 接 
字 ， 并 将 其 与 端口 (8124 ) 绑 定 ， 然 后 监听 消息 事件 。 当 有 新 的 数据 到 达 时 ， 应 用 
程序 使 用 console.log 方法 将 其 打印 出 来 ， 一 并 打印 输出 的 还 有 数据 发 送 方 的 IP 地 
址 和 端口 号 。 特 别 要 注意 的 是 ， 在 输出 接收 到 的 信息 时 ，buffer 对 象 会 自动 将 数据 
转换 成 一 个 字符 串 。 


我 们 并 非 必 须 将 UDP 套 接 字 绑 定 到 茶 个 端口 上 。 如 果 没 有 指定 绑 定 的 端口 ，UDP 
套 接 字 将 和 尝试 监听 所 有 端口 。 
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示例 3-7 创建 UDP 服务 端 ， 绑 定 8124 端口 并 接收 数据 
var dgram = require('dgram' ); 
var server = dgram.createSocket("udp4") ; 
server.on ("message", function(msg, rinfo) { 
console. log("Message: " + msg + " from " + rinfo.address + ":" 


+ rinfo.port); 


}); 

server .bind(8124); 
无 论 在 UDP 客户 端 还 是 服务 端的 代码 中 ， 当 发 送 或 者 接收 到 数据 后 ， 我 们 并 没有 
调用 任何 close 方法 来 关闭 套 接 字 。 因 为 在 客户 端 和 服务 闯 之 间 并 没有 维护 一 个 持 
续 连 接 ， 我 们 仅仅 是 使 用 套 接 字 提供 的 功能 来 发 送 和 接收 消息 。 
3.3.4 流 、 管 道 和 Readline 
在 前 面 几 节 所 讨论 的 套 接 字 之 间 的 通信 流 实际 上 是 底层 抽象 接口 stream 的 一 个 实 


现 。 流 可 读 、 可 写 或 可 读 写 , 而 且 所 有 流 也 都 是 EventEmitter 的 实例 ( 即将 在 “Events 
和 EventEmitter” 一 节 讨 论 )。 


实际 上 所 有 与 通信 相关 的 流 , 包 括 process.stdin Fil process.stdout , 它们 都 是 抽象 接口 stream 
的 具体 实现 。 由 于 实现 了 这 一 基本 接口 ，Node 中 所 有 流 都 支持 一 套 基本 的 功能 调用 : 


。 你 可 以 通过 setEncoding 方法 更 改 流 数据 所 使 用 的 编码 方式 ; 

你 可 以 检查 当前 流 是 否 可 读 ， 是 否 可 写 ， 或 着 是 否 可 该 写 ; 

你 可 以 捕 提 流 事件 , 如 接收 到 新 数据 或 连接 关闭 , 并 能 为 每 个 事件 附加 回调 函数 ， 
。 ”你 可 以 挂 起 和 恢复 流 ， 
。 你 可 以 使 用 pipe 将 一 个 可 读 流 与 一 个 可 写 流连 接 起 来 。 


上 面 的 最 后 一 个 pipe 功能 是 我 们 之 前 未 曾 使 用 过 的 。 我 们 可 以 打开 一 个 REPL 会 
话 并 键入 以 下 内 容 来 简单 测试 下 这 个 功能 : 


> process.stdin.resume() ; 
> process.stdin.pipe(process.stdout) ; 


此 时 ， 你 输入 的 任何 信息 将 立即 回 显 给 你 。 


如 果 你 想 让 输出 流 保持 打开 状态 并 接收 连续 输入 的 数据 ， 可 以 在 调用 pipe 方法 时 
传人 参数 { end: false }: 


process.stdin.pipe(process.stdout, { end : false }); 
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Node 中 还 为 只 读 流 提供 了 特定 功能 : readline。 你 可 以 使 用 如 下 代码 来 将 Readline 
模块 包含 到 你 的 程序 中 : 

var readline = require('readline'); 
Readline 模块 文 持 按 行 谈 取 流 。 但 是 需要 注意 的 是 ， 一 旦 你 在 Node 程序 中 包括 
这 个 模块 并 创建 了 接口 来 使 用 它 ， 程 序 将 不 会 终止 ， 直 到 你 关闭 这 个 接口 以 及 标 
准 输入 流 。Node 主 站 文档 中 包含 了 一 个 如 何 开 始 和 终止 Readline 接口 的 示例 代 
亿 ， 我 对 其 进行 适当 修改 后 得 到 了 示例 3-8 的 代码 。 当 你 运行 这 段 示 例 代 码 时 ， 
它 会 提出 一 个 问题 , 然后 输出 你 输入 的 信息 作为 答案 。 它 也 可 以 监听 其 他 任何 “ 命 
令 ”, 其 实 就 是 以 换行 特 结 尾 的 字符 串 。 如 果 命 令 是 “.leave”, 则 退出 程序 ; 否则 ， 
将 命令 内 容重 复 输出 到 终端 。 当 然 使 用 CTRL+C 或 Ctrl+D 组 合 键 可 以 终止 应 用 
程序 。 


示例 3-8 使 用 Readline 库 创建 一 个 简单 的 命令 驱动 型 用 户 界 面 


var readline = require('readline' ); 


// create a new interface 
var interface = readline.createInterface(process.stdin, process.stdout, null); 


// ask question 

interface.question(">>What is the meaning of life? ", function(answer) { 
console. log("About the meaning of life, you said ”+ answer); 
interface.setPrompt(">>"); 
interface.prompt(); 


jor 


// function to close interface 
function closeInterface() { 
console. log('Leaving interface...'); 
process.exit(); 


// listen for .leave 
interface.on(‘line’, function(cmd) { 
if (cmd.trim() == '.leave') { 
closeInterface(); 
return; 
} else { 
console.log("repeating command: " + cmd); 


interface.setPrompt(">>"); 
interface. prompt() ; 


H3 


interface.on('close', function() { 
closeInterface(); 


}); 
下 面 是 执行 结果 示例 : 
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>>What is the meaning of life? === 

About the meaning of life, you said === 

>>This could be a command 

repeating command: This could be a command 

>>We could add eval in here and actually run this thing 

repeating command: We could add eval in here and actually run this thing 
>>And now you know where REPL comes from 

repeating command: And now you know where REPL comes from 

>>And that using rlwrap replaces this Readline functionality 

repeating command: And that using rlwrap replaces this Readline functionality 
>>Time to go 

repeating command: Time to go 

>>. leave 

Leaving interface... 


这 应 该 很 熟悉 。 还 记得 我 们 在 第 2 章 中 用 rlwrap 来 覆盖 REPL 命令 行 功能 , 并 使 用 
以 下 指令 来 使 其 生效 : 


env NODE NO READLINE=1 rlwrap node 


现在 我 们 可 以 知道 这 人 名 指令 背后 具体 做 了 什么 ,其实 就 是 让 REPL 使 用 rlwrap 代替 
Node 的 Readline 模块 来 进行 命令 行 处 理 。 


ZJE, Xt Node 中 的 stream 模块 的 简要 介绍 已 经 完成 。 是 时 候 改 变 主题 ， 去 了 解 下 
Node.js 中 的 子 进 程 了 。 


3.4 子 进程 


操作 系统 提供 给 我 们 访问 计算 机 资源 的 很 多 功能 , 其 中 很 大 一 部 分 震 要 通过 命令 行 
方式 来 进行 。 如 采 能 从 Node 应 用 程序 中 访问 这 些 功 能 ， 就 再 好 不 过 了 。 这 也 正 是 
在 Node 中 使 用 子 进 程 的 目的 。 

Node 人 允许 我 们 在 一 个 新 的 子 进程 中 运行 系统 命令 ， 并 能 监听 并 获取 子 进程 的 输 
入 /输出 信息 。 这 包括 能 够 将 参数 传递 给 该 子 进 程 中 运行 的 命令 ， 甚 至 能 将 一 个 
命令 的 执行 结果 管道 给 为 一 个 命令 作为 输入 。 接 下 来 的 几 市 会 更 详细 地 探讨 这 
个 功能 。 


isc Ae 
a A 

al EE cebkebiiat en 
命令 。 它 们 可 以 工作 在 Linux 系统 上 ， 应 该 也 可 以 工作 在 Mac 系统 
中 。 但是， 它们 不 能 工作 在 Windows 命令 窗口 中 。 
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3.4.1 child_process.spawn 

有 四 种 不 同 的 技术 来 创建 一 个 子 进程 。 其 中 最 常见 的 是 使 用 spawn 方法 。 这 个 方法 
会 启动 一 个 新 的 子 进程 , 然后 在 该 子 进 程 中 执行 命令 , 同时 还 可 以 为 需要 执行 的 命 
令 指 定 任何 参数 。 在 下 面 的 示例 中 ， 我 们 将 创建 一 个 子 进程 并 调用 Unix 的 pwd 命 
令 来 显示 当前 目录 。 该 命令 不 带 任何 参数 


var spawn = requirel('child process').spawn, 
pwd = spawn ('pwd'); 


pwd.stdout.on('data', function (data) { 
console.log('stdout: ' + data); 
}); 


pwd.stderr.on('data', function (data) { 
console.log('stderr: ' + data); 


} ); 


pwd.on('exit', function (code) { 
console.log('child process exited with code ' + code); 


注意 代码 中 对 子 进 程 的 stdout 和 stderr 相关 事件 的 捕获 。 如 果 没 有 错误 发 生 ， 任 何 
命令 的 输出 将 被 发 送 到 子 进程 的 stdout， 然 后 触发 一 个 data 事件 。 如 果 发 生 错 误 ， 
比如 我 们 传递 了 无 效 的 命令 参数 : 


var spawn = require('child_process').spawn, 
pwd = spawn('pwd', ['-g']); 
错误 信息 将 被 发 送 到 子 进程 的 stderr， 然 后 被 输出 到 控制 台 上 显示 : 
stderr: pwd: invalid option == '‘'g' 


Try ‘pwd --help' for more information. 
child process exited with code 1 


子 进 程 退 出 代码 1， 表 示 发 生 了 错误 。 注 意 退 出 代码 会 有 所 不 同 ， 这 取决 于 操作 系 
统 以 及 具体 的 错误 原因 。 当 没有 发 生 错 误 时 ， 子 进程 退出 代码 为 0。 


前 面 的 代码 描述 了 在 何 种 情况 下 会 输出 何 种 信息 给 子 进程 的 stdout 和 stderr, 但 如 何 使 用 
stdin WÉ? Node 主 站 文档 中 对 如 何 将 数据 导入 stdin 有 一 段 示例 。 它 模拟 了 Unix 的 管道 (| ) 
功能 ， 可 以 将 一 个 命令 的 结果 传递 给 另 一 个 命令 做 为 输入 。 我 改编 了 该 示例 代码 ， 以 说 
明 如 何 实现 按 文件 名 递归 搜索 文件 ， 这 也 是 我 喜欢 的 Unix 管道 用 法 之 一 : 
find . -ls | grep test 

示例 3-9 通过 子 进程 实现 了 这 一 功能 。 需 要 注意 的 是 第 一 条 命令 用 于 执行 查找 ， 它 有 
两 个 参数 ， 而 第 二 条 命令 仅 有 一 个 参数 : 即 从 stdin 传递 进来 的 搜索 条 件 (文件 名 所 包 
含 的 关键 字 )。 还 要 注意 ， 与 Node 文档 示例 代码 不 同 的 是 ，grep TREX stdout 的 编 
码 方式 需要 通过 setEncoding 来 修改 。 和 否则， 数据 只 能 被 当 作 一 个 buffer 对 象 输出 。 


50 第 3 章 


示例 3-9 使 用 子 进程 实现 对 包含 有 关键 词 “test” 的 文件 名 的 目录 递归 搜索 
var spawn = require('child process').spawn, 
find = spawn('find',['.','-ls']), 
grep = spawn('grep',['test']); 


grep.stdout.setEncoding('utf8'); 


// direct results of find to grep 

find. stdout.on('data’, function(data) { 
grep.stdin.write(data) ; 

}); 


// now run grep and output results 
grep.stdout.on('data', function (data) { 
console. log(data) ; 


Hs 


// error handling for both 
find.stderr.on('data', function (data) { 
console.log('grep stderr: ' + data); 
grep.stderr.on('data', function (data) { 
console.log('grep stderr: ' + data); 
// and exit handling for both 
find.on('exit', function (code) { 
if (code !== 0) { 
console.log('find process exited with code ' + code); 


// go ahead and end grep process 
grep.stdin.end(); 


grep.on('exit', function (code) { 
if (code !== 0) { 
console.log('grep process exited with code ' + code); 
} 
})3 
当 你 运行 应 用 程序 后 ， 你 会 得 到 当前 目录 以 及 所 有 子 目 录 中 包含 “test” 字 符 
的 文件 名 。 


至 今 为 止 ， 所 有 的 示例 程序 都 可 以 工作 在 Node 0.8 版 本 和 Node 0.6 版 本 。 但 由 于 
Node 不 同 版 本 之 间 底 层 API 的 变化 ， 示 例 3-9 是 一 个 例外 。 


在 Node 0.6 版 本 中 , 只 有 子 进 程 退 出 并 且 所 有 的 STDIO 管道 关闭 后 , 才能 产生 exit 
事件 。 而 在 Node 0.8 版 本 中 ， 当 子 进 程 结束 后 exit 事件 会 立即 产生 。 这 会 导致 我 
ATA FB Att, TAA grep 子 进 程 会 在 STDIO 管道 关闭 后 试图 处 理 其 数据 。 如 
果 和 希望 应 用 程序 能 够 工作 在 Node 0.8 版 本 中 ,应 用 程序 需要 监听 find 子 进程 的 close 
事件 ， 而 不 是 exit 事件 : 
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// and exit handling for both 


find.on('close', function (code) { 
if (code !== 0) { 
console.log('find process exited with code ' + code); 


} 
// go ahead and end grep process 
grep.stdin.end(); 

} ) 7 


在 Node 0.8 版 本 ，close 事件 会 在 子 进 程 退 出 并 且 所 有 的 STDIO 管道 关闭 后 
meee oe 


3.4.2 child _process.exec 和 child_process.execFile 

除了 通过 spawn 来 生成 并 执行 一 个 子 进 程 ， 你 也 可 以 使 用 child_process.exec 和 
child process.execFile 来 启动 shell 执行 命令 ， 同 时 命令 执行 结果 可 以 被 缓存 。 
child process.exec 和 child process.execFile 之 间 的 唯一 区 别 在 于 execFile 会 执行 指 
定 的 可 执行 文件 ， 而 不 是 运行 一 SATS o 

这 两 种 方法 的 第 一 个 参数 是 需要 执行 的 命令 或 文件 路 径 , 第 二 个 是 一 个 可 选 参数 列 
表 ， 第 三 个 参数 是 一 个 回调 困 数 ， 该 回调 毅 数 有 三 个 参数 : error, stdout 和 stderr. 
如 果 没 有 错误 发 生 ， 执 行 结果 会 保存 到 stdout. 

如 果 存 在 一 个 可 执行 文件 ， 并 包含 如 下 内 容 : 


#! /usr/local/bin/node 
console.log (global); 


以 下 代码 会 打印 并 输出 被 缓存 的 执行 结果 : 


var execfile = require('child_process').execFile, 
child; 
child = execfile('./app.js', function(error, stdout, stderr) { 
if (error == null) { 
console.log('stdout: ' + stdout); 


} 
1) 4 


3.4.3 child_process.fork 

最 后 一 个 子 进程 方法 是 child_process.fork。 其 实 是 对 spawn 方法 的 封装 ， 目 的 是 为 
了 启动 子 进程 并 运行 Node.js 模块 。 

不 同 于 其 他 子 进程 创建 方法 , fork 方法 会 在 父 进程 与 子 进程 之 间 建 立 一 个 真实 的 通 
信 管道 但 是 要 注意 ,通过 fork 生成 的 每 个 子 进程 都 需要 一 个 全 新 的 V8 实例 ,这 
需要 耗费 更 多 时 间 和 内 存 。 
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Aa 提示 
Node 文档 中 对 fork 的 使 用 提供 了 一 些 很 好 的 示例 。 


3.4.4 在 Windows 系统 中 使 用 子 进程 

之 前 我 们 提 到 , 调用 Unix 系统 命令 的 子 进程 无 法 工作 在 Windows 系统 中 , 反之 
亦 然 。 虽 然 这 是 显而易见 的 ， 但 并 不 是 每 个 人 都 能 注意 到 它 ， 不 像 运 行 在 浏览 
器 中 的 JavaScript 程序 ， 在 不 同 操作 系统 环境 中 ，Node 应 用 程序 会 表现 出 不 同 
的 行为 。 


直到 最 近 ，Windows 系统 上 的 Node 二 进 制 安装 包 才 提供 了 对 子 进程 的 访问 支持 。 
你 需要 通过 Windows 命令 解释 器 cmd.exe 来 运行 任何 你 想 执 行 的 命令 。 


示例 3-10 演示 了 如 何 执行 一 个 Windows 命令 。 在 这 段 示 例 代码 中 ， 我 们 使 用 
Windows 的 cmd.exe 来 执行 dir 命令 (显示 目录 内 容 )， 并 通过 监听 data 事件 来 获 
取 命 令 执 行 结果 ， 然 后 输出 。 


示例 3-10 在 Windows 系统 中 运行 一 个 子 进 程 
var cmd = require('child process').spawn('cmd', ['/c', ‘dir\n']); 


cmd.stdout.on(‘data', function (data) { 
console.log('stdout: ' + data); 
}); 


cmd.stderr.on('data’, function (data) { 
console.log('stderr: ' + data); 


}); 


cmd.on('exit', function (code) { 
console.log('child process exited with code ' + code); 


H; 


传递 给 cmd.exe 的 第 一 个 参数 是 “/c”, 它 用 来 指示 在 cmd.exe 执行 完 命令 后 就 立即 
终止 并 退出 。 如 果 没 有 这 个 参数 ， 这 段 Node 程序 将 不 能 正常 工作 。 当 然 ， 我 们 更 
不 想 传送 参数 “水 ”给 cmd.exe， 因 为 它 会 告诉 cmd.exe 执行 命令 并 保持 ， 这 样 你 
的 应 用 程序 将 不 会 终止 。 


提示 
我 们 会 在 第 9 章 和 第 12 章 对 子 进程 有 更 详细 的 说 明 . 
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3.5 ”域名 解析 和 URL 处 理 


DNS 模块 使 用 了 库 c-ares 来 提供 DNS 解析 功能 ，c-ares 是 一 个 采用 C 语言 开发 的 
库 , 可 以 提供 异步 方式 的 DNS 请 求 和 解析 。 对 于 需要 处 理 域名 或 卫 地 址 的 应 用 程 
FX, Node 中 DNS 模块 和 其 他 一 些 相 关 模 块 是 非常 有 用 的 。 


使 用 dns.lookup 方法 可 以 解析 并 得 到 一 个 域名 的 IP 地 址 ， 在 下 面 的 代码 中 ， 我 们 
会 将 解析 到 的 IP 地 址 输出 到 终端 : 


var dns = require('dns'); 
dns.lookup('burningbird.net',function(err,ip) { 
if (err) throw err; 
console.log(ip); 


} ); 
使 用 dns.reverse 方法 则 会 根据 给 定 的 IP 地 址 返回 一 组 域名 : 


dns.reverse('173.255.206.103', function(err,domains) { 
domains.forEach(function(domain) { 
console.log(domain) ; 
}); 
} ) ; 


dns.resolve 方法 会 根据 指定 的 记录 类 型 返回 一 组 记录 ,常见 的 记录 类 型 有 A、MX、NS 
等 。 下面 的 代码 描述 了 如 何 查 找 出 解析 域名 “burningbird.net” 所 用 的 域名 服务 器 : 


var dns = require('dns'); 
dns.resolve('burningbird.net', 'NS', function(err,domains) { 
domains.forEach(function(domain) { 
console.log (domain); 
a 
} ) ; 


返回 的 结果 是 : 


nsl.linode.com 
ns3.linode.com 
ns5.linode.com 
ns4.linode.com 


在 第 1 章 示 例 1-3 中 , 我们 使 用 了 URL 模块 。 这 个 简单 的 模块 可 以 提供 URL 解析 
功能 ， 并 能 返回 一 个 对 象 来 描述 URL 中 的 所 有 信息 。 如 下 代码 所 示 : 


var url = require('url'); 
var urlObj =url.parse('http://examples.burningbird.net:8124/?file=main'); 
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返回 值 为 一 个 JavaScript 对 象 : 


{ protocol: 'http:', 
slashes: true, 
host: 'examples.burningbird.net:8124', 
port: '8124', 
hostname: 'examples.burningbird.net', 
href: 'http://examples.burningbird.net:8124/?file=main', 
search: '?file=main', 
query: 'file=main', 
pathname: '/', 
path: '/?file=main' } 
对 象 中 的 每 个 属性 可 以 被 分 别 访问 ， 像 这 样 : 
var qs = urlObj.query; // 获得 查询 字符 串 
调用 URL .format 方法 可 以 执行 相反 的 操作 : 
console.log(url.format (urlObj)); // 返回 原始 URL 
URL 模块 常常 与 Query String 模块 一 并 使 用 。 后 者 是 一 个 简单 的 工具 模块 , 它 提供 
对 查询 字符 串 的 解析 功能 ， 也 可 以 被 用 来 生成 查询 字符 串 。 


可 以 使 用 querystring.parse 方法 取得 查询 字符 串 中 的 键 值 对 。 如 下 所 示 : 
var vals = querystring.parse('file=main&file=secondary&type=htmL") ; 
查询 结果 同样 保存 在 一 个 JavaScript 对 象 中 , 可 以 轻松 简单 地 对 每 个 键 值 进行 单独 访问 : 
{ file: [ 'main', 'secondary' ], type: 'html' } 


由 于 file 在 查询 字符 串 中 出 现 了 两 次 ,所 以 其 对 应 的 两 个 值 被 保存 到 了 一 个 数组 中 ， 
每 一 个 都 可 以 被 单独 访问 : 


console.log(vals.file[0]); // returns main 


你 同样 也 可 以 将 一 个 保存 有 键 值 对 的 对 象 转换 为 查询 字符 串 ， 使 用 
querystring.stringify 方法 即 可 : 


var gryString = querystring.stringify(vals) 


3.6 Utilities 模块 和 对 和 象 继承 
Utilities 模块 提供 了 一 些 非常 实用 的 功能 。 你 可 以 通过 “util" 来 包含 这 个 模块 : 


var util = require('util'); 
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你 可 以 使 用 Utilities 模块 来 测试 一 个 对 象 是 否 是 数组 ( utilisArray ) 或 正则 表达 式 
(util.isRegExp ), 或 者 将 其 格式 化 成 一 个 字符 串 ( util.format )。 最 近 还 增加 了 一 个 新 的 实 
验 性 功能 ， 用 于 将 可 读 流 的 数据 输出 到 可 写 流 (utiLpump ): 


util.pump (process.stdin, process.stdout) ; 


不 过 , 我 不 想 在 REPL 中 运行 此 代码 ， 因 为 这 会 将 你 键入 的 任何 字符 回 显 出 来 ， 从 
而 使 得 当前 的 REPL 显得 混乱 。 


我 经 常 使 用 util.inspect 来 获得 一 个 对 象 的 描述 信息 。 当 你 想 了 解 某 个 对 象 的 更 多 
信息 时 ， 这 是 一 个 很 好 的 方法 。inspect 方法 的 第 一 参数 是 必 选 的 ， 传 人 你 想 查 看 的 对 
象 即 可 ; 第 二 个 是 可 选 参数 , 决定 了 是 否 需要 查看 对 象 的 中 不 可 枚 举 ( nonenumerable ) 
属性 ; 第 三 个 可 选 参数 指定 了 递归 次 数 ， 即 所 能 查看 的 对 象 信 息 的 次 度 ; 第 四 个 参数 
也 是 可 选 的， 指定 是 否 使 用 ANSI 颜色 输出 信息 。 如 果 第 三 个 参数 是 一 个 空 值 null， 

则 表示 无 限 递归 (默认 为 2 )， 该 方法 会 尽 可 能 详尽 的 检查 对 象 。 从 以 往 的 经 验 来 看 ， 

我 们 还 是 需要 小 心 使 用 空 深 度 ， 因 为 你 可 能 获得 大 量 的 输出 信息 。 


你 可 以 在 REPL 中 练习 使 用 util.inspect， 不 过 我 推荐 使 用 下 面 这 个 简单 的 小 程序 : 


var util = require('util'); 
var jsdom = require('jsdom'); 


console.log(util.inspect (jsdom, true,null,true) ); 
当 你 运行 它 时 ， 请 将 输出 重 定向 到 一 个 文件 : 


node inspectjsdom.js > jsdom.txt 


现在 ,你 可 以 随时 的 查阅 这 个 对 象 接口 。 再 次 提醒 如果 你 使 用 空 深度 ， 可 能 会 得 
到 非常 大 的 输出 文件 。 

Utilities 模块 还 提供 了 男 外 一些 方法 ，util.inherits 是 比较 常用 的 一 个 。 它 需要 两 个 
参数 constructor 和 superConstructor。 方 法 的 执行 结果 是 constructor 将 继承 
superConstructor 的 功能 。 


示例 3-11 展示 了 在 使 用 util.inherits 方法 时 所 需要 留意 的 一 些 细节 问题 。 示 例 代 码 
后 面 是 关于 代码 的 具体 说 明 。 


aa 提示 


示例 3-11 及 其 说 明 包 括 了 一 些 你 可 能 已 经 很 熟悉 的 JavaScript 特性 。 
”但 我 们 的 目标 是 要 使 得 所 有 读 完 本 小 节 的 读者 对 于 所 发 生 的 事情 有 
着 同样 的 理解 。 
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示例 3-11 使 用 util.inherits 方法 实现 继承 
var util = require(‘util'); 


// define original object 
function first() { 
var self = this; 
this.name = 'first'; 
this.test = function() { 
console. log(self.name) ; 


} 


first.prototype.output = function() { 
console. log(this.name) ; 


J 


// inherit from first 

function second() { 
second.super_.call(this) ; 
this.name = 'second'; 


util.inherits(second, first); 


var two = new second(); 


function third(func) { 
this.name = “ third ; 
this.callMethod = func; 
} 


var three = new third(two.test); 


// all three should output "second" 
two.output(); 

two.test(); 

three.callMethod() ; 


在 示例 程序 中 ， 我 们 创建 了 三 个 对 象 ， 分 别 命名 为 first、second 和 third. 


第 一 个 对 象 包 含有 两 个 方法 :test 和 output。otest 方 法 直接 定义 在 对 象 中 ,而 output 
方法 是 通过 原型 后 添加 进来 的 。 之 所 以 使 用 两 种 方式 来 定义 同一 个 对 象 上 的 两 
个 方法 ， 是 为 了 能 更 好 的 说 明 在 使 用 util.inherits 进行 对 象 继承 时 需要 留意 的 技 
术 细 节 。 
第 二 个 对 象 的 定义 中 包含 如 下 代码 : 

second. super_.call (this); 


MRR AX — REMA AIRE RR GR, 那么 我 们 依然 可 以 成 功 的 
调用 second 对 象 中 的 output 方法 ,但 如 果 尝 试 调用 test 方法 ， 则 应 用 程序 会 产生 
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一 个 错误 并 且 终 止 ， 同 时 获得 一 个 错误 信息 ， 提 示 test 方法 未 定义 。 


由 于 second 对 象 继承 了 first 对 象 ， 这 名 代码 中 的 call 方法 能 将 两 个 对 象 的 构造 也 
数 关联 起 来 , 以 确保 在 调用 second 对 象 的 构造 呆 数 时 , first 对 象 的 构造 函数 也 同时 
能 够 被 调用 。 


我 们 之 所 以 需要 在 second 构造 晒 数 中 调用 first 的 构造 另 数 ， 因 为 在 first APE PKI 
数 被 调用 前 test 方法 是 不 存在 的 。 然 而 ， 对 于 output 方法 我 们 并 不 需要 这 么 做 ， 因 
为 它 是 在 first 原型 上 直接 定义 的 。 当 second 继承 了 first 的 属性 时 ， 它 同时 也 继承 
这 个 方法 。 


在 util.inherits 的 实现 中 ， 我 们 可 以 看 到 有 关 super 的 定义 : 


exports.inherits = function(ctor, superCtor) { 
ctor.super_ = superCtor; 
ctor.prototype = Object.create(superCtor.prototype, { 
constructor: { 


value: ctor, 
enumerable: false, 
writable: true, 
configurable: true 
} 
} ) ; 
}; 


调用 util.inherits 方法 时 ，super 会 作为 一 个 新 的 属性 被 添加 到 second 对 象 上 : 


util.inherits (second, first); 


在 示例 应 用 程序 中 还 使 用 到 了 第 三 个 对 象 third， 它 同样 也 定义 了 name JAE. third 
并 没有 继承 自 first 或 second, 但 却 需要 在 其 实例 化 时 传人 一 个 吨 数 作为 参数 。 被 传 
入 的 函数 会 在 callMethod 方法 中 调用 。 在 示例 代码 中 ， 我 们 将 second 对 象 的 test 
方法 传递 给 了 third 对 象 的 构造 函数 来 实例 化 它 : 


var three = new third(two.test); 


乍 看 之 下 ,我 们 可 能 会 以 为 在 three.callMethod 方法 被 调用 时 会 输出 “third”， 
但 实际 上 输出 的 是 “second”。 这 也 正 是 我 们 在 first 对 象 中 使 用 self 引用 的 
原因 。 


在 JavaScript 中 ，this 用 于 描述 一 个 对 象 的 上 下 文 ， 当 一 个 函数 被 作为 参数 传递 时 
( 比如 传递 给 事件 处 理 程序 )，this 将 会 发 生 切 换 。 如 果 期 望 此 少数 仍然 使 用 所 属 对 
象 的 数据 的 话 ， 唯 一 方法 是 将 this 赋值 给 一 个 对 象 内 变量 ( self )， 然 后 在 函数 定义 
中 使 用 该 对 象 变量 。 
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“运行 这 个 应 用 程序 后 得 到 的 输出 结果 如 下 : 
second 


second 
second 


对 于 客户 端 JavaScript 开发 人 员 来 说 ， 这 些 知 识 点 应 该 比较 熟悉 ， 而 且 有 助 于 正确 
理解 Utilities 模块 的 继承 功能 。 接 下 来 的 一 节 中 我 们 会 介绍 Node 中 的 EventEmitter， 
这 项 功能 在 很 大 程度 上 依赖 于 本 市 所 描述 的 继承 行为 。 


3.7 Events 和 EventEmitter 


Node 核心 库 中 许多 对 象 的 背后 实现 中 都 使 用 到 了 EventEmitter。 对 于 可 以 产生 事件 
并 能 通过 on 方法 绑 定 事件 处 理 男 数 的 对 象 来 说 ， 几 乎 无 一 例外 都 是 通过 继承 
EventEmitter 来 实现 的 。 学习 使 用 Node 开发 时 ， 了 解 EventEmitter 的 工作 原理 以 及 
如 何 使 用 它 是 非常 重要 的 。 


EventEmitter 是 Node 提供 的 可 以 为 其 他 对 象 提供 异步 事件 处 理 功能 的 对 象 。 为 了 
说 明 其 核心 功能 ， 我们 将 快速 实现 一 个 测试 程序 。 
首先 ， 包 含 Events 模块 : 
var events = require('events'); 
接 下 来 ， 创 建 一 个 EventEmitter 的 实例 : 


var em = new events.EventEmitter(); 


使 用 新 创建 的 EventEmitter 实例 来 完成 两 个 基本 任务 : 为 指定 事件 添加 事件 处 理 程 
序 ， 激 发 并 产生 事件 。 当 一 个 特定 的 事件 产生 时 ， 名 为 on 的 事件 处 理 呆 数 将 被 触 
发 。 该 方法 的 第 一 个 参数 是 事件 名 称 ， 第 二 个 参数 为 事件 处 理 冰 数 : 


em.on('someevent', function(data) { ... }); 


当 某 些 条 件 满 足 之 后 ， 我 们 可 以 通过 emit 方法 来 激发 对 象 上 的 事件 : 


if (somecriteria) { 
en.emit ('data'); 


} 


在 示例 3-12 中 ， 我 们 创建 了 一 个 EventEmitter 的 实例 用 于 产生 事件 timed， 该 事件 
每 隔 三 秒 被 触发 一 次 。 而 在 对 应 该 事件 的 处 理 郴 数 中 , 我 们 会 将 一 个 计数 器 信息 输 
出 到 控制 台 。 
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示例 3-12 EventEmitter 基本 功能 示例 


var eventEmitter = require('events').EventEmitter; 
var counter = 0; 


var em = new eventEmitter(); 
setInterval(function() { em.emit('timed', counter++); }, 3000); 


em.on('timed', function(data) { 
console.log('timed ' + data); 


b 


运行 示例 程序 后 ,计数 信 息 被 定时 输出 到 控制 台 ， 直 到 应 用 程序 被 终止 。 


这 是 一 个 有 趣 的 示例 。 但是, 我 们 需要 的 往往 是 将 EventEmitter 功能 添加 到 代码 的 
现 有 对 象 中 ， 而 不 仅仅 是 在 整个 应 用 中 直接 使 用 EventEmitter 的 实例 。 
为 了 实现 这 一 目的 ， 我 们 可 以 使 用 上 一 节 提 到 的 util.inherits 方法 : 
util.inherits(someobj, EventEmitter) ; 
在 对 象 上 使 用 util.inherits 方法 后 ， 你 就 可 以 在 定义 该 对 象 的 方法 时 调用 emit 方法 
来 激发 事件 ， 同 时 也 可 以 为 该 对 象 的 实例 编写 事件 处 理 消 数 了 : 
someobj .prototype.somemethod = function() { this.emit('event'); }; 


someobjinstance.on('event', function() { }); 
在 下 面 示例 3-13 的 代码 中 ， 说 明了 如 何 遂 过 继承 的 方法 为 一 个 对 象 添加 EventEmitter 所 
提供 的 功能 ， 它 能 从 更 加 实用 的 角度 让 我 们 理解 EventEmitter 是 如 何 工 作 的 。 在 这 个 示 
例 中 , 我 们 创建 了 一 个 新 对 象 nputChecker。 该 对 象 的 构造 吨 数 需要 两 个 参数 : 第 一 个 代 
表 人 名 ， 用 来 传 值 给 对 象 变量 name; 第 二 个 是 一 个 文件 名 ， 被 用 来 生成 可 写 流 对 象 
writeStream。 代 码 中 我 们 通过 调用 Node 文件 系统 模块 中 的 createWriteStream 方法 来 创建 
一 个 可 写 流 (在 下 面 的 说 明 栏 中 ， 我 们 对 文件 系统 中 的 可 读 流 和 可 写 流 有 更 多 介绍 )。 


可 读 写 流 


使 用 Node 的 文件 系统 模块 (fs ) 可 以 打开 文件 并 进行 读 写 操作 ， 或 者 监视 指定 文件 是 否 有 新 的 活 
动 , 还 可 以 对 文件 系统 的 目录 结构 进行 维护 。 同 时 它 还 为 我 们 提供 可 读 流 和 可 写 流 来 操作 文件 内 容 。 


你 可 以 使 用 fs .createReadstreanm 方法 并 传人 文件 名 称 、 文 件 路 径 或 其 他 可 选项 来 创建 一 个 
可 读 流 。 也 可 以 使 用 fs . createWriteStream 方法 并 传人 文件 名 称 和 路 径 来 创建 一 个 可 写 流 。 
如 果 你 期 望 通过 事件 驱动 方式 来 操作 文件 ， 并 且 需 要 频繁 读 写 文件 内 容 时 ， 使 用 可 读 写 流 是 
一 个 好 的 选择 。 程 序 后 台 会 打开 流 并 将 所 有 读 写 操作 放 入 队列 然后 按 序 进行 处 理 。 








check 是 男 一 个 对 象 方法 ， 用 于 从 输入 数据 中 解析 特定 命令 信息 。 命 令 “wr:” 会 触发 
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write 事件 ， 命 令 “en:” 是 一 个 end 事件 。 当 无 法 解析 出 命令 信息 时 ， 则 触发 “echo” 
MF AES TPT R KAA A SA RER TE Ah PR MT write 事件 的 处 理 是 
将 :” 命 令 之 后 的 信息 写 人 到 可 写 流 writeStream 中 ， 对 echo 事件 的 处 理 是 将 收 到 
Hie ALLER 出 到 终端 ,对 end 事件 的 处 理 是 使 用 process.exit 方法 来 结束 并 退出 程序 。 


所 有 输入 都 来 自 标 准 输入 〈process.stdin )。 
示例 3-13 通过 继承 EventEmitter 创建 支持 事件 功能 的 对 象 


var util = require( util ); 
var eventEmitter = require('events').EventEmitter; 
var fs = require('fs'); 


function inputChecker (name, file) { 
this.name = name; 
this.writeStream = fs.createWriteStream('./' + file + ‘.txt', 
{'flags' : ‘a’, 
‘encoding’ : ‘utf8', 
'mode' : 0666}); 
}; 


util.inherits(inputChecker,eventEmitter); 


inputChecker.prototype.check = function check(input) { 
var command = input.toString().trim().substr(0,3); 


if (command == 'wr:') { 
this.emit('write',input.substr(3,input.length)); 
} else if (command == 'en:') { 
this.emit(‘end'); 
} else { 
this.emit( ‘echo’ , input) ; 
}; 


// testing new object and event handling 
var ic = new inputChecker('Shelley', ‘output’ ); 


ic.on('write’, function(data) { 
this.writeStream.write(data, ‘utf8"'); 


})3 


ic.on('echo', function( data) { 
console. log(this.name + ' wrote ' + data); 


}); 


ic.on(‘end', function() { 
process.exit(); 


})5 


process.stdin.resume(); 

process.stdin.setEncoding(‘utf8'); 

process.stdin.on('data', function(input) { 
ic.check(input) ; 

})5 


示例 代码 中 ， 与 EventEmitter 相关 的 代码 均 用 粗 体 标 注 。 值 得 注意 的 是 
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process.stdin.on 也 用 粗 体 标注 了 出 来 , 这 是 因为 process.stdin 也 是 Node 中 众多 继承 
了 EventEmitter 功能 的 对 象 之 一 。 


前 面 草 节 我 们 介绍 过 util.inherits 方法 ， 同 时 在 示例 3-13 中 我 们 并 没有 在 对 象 的 构 
造 图 数 中 调用 EventEmitter 构造 水 数 ， 这 是 因为 我 们 需要 的 on 和 emit 方法 定义 在 
EventEmitter 对 象 的 原型 中 ， 而 并 没有 定义 在 实例 属性 中 。on 方法 就 像 是 
EventEmitteraddListener 方法 的 别名 ， 它 们 有 着 同样 的 参数 ， 因 此 : 


ic.addListener('echo', function( data) { 
console.log(this.name + ' wrote ' + data); 


}); 
与 下 面 这 两 句 代 人 码 是 完全 一 致 的 : 


ic.on('echo', function( data) { 
console.log(this.name + ' wrote ' + data); 


} ) ; 
另外 你 可 以 只 在 某 个 事件 第 一 次 被 触发 时 调用 事件 处 理 冰 数 : 
ic.once(event, function); 


默认 情况 下 ,如 果 一 个 事件 挂 载 了 多 于 10 TAREE PRA th ALLA 10 个 listeners ), 
那么 你 会 得 到 一 条 警告 信息 。 不 过 通过 调用 setMaxListeners 方法 并 传人 一 个 数字 , 
我 们 可 以 轻松 修改 这 个 限制 ， 注 意 使 用 0 则 表示 无 限制 。 


Node 中 的 许多 对 象 ,包括 一 些 第 三 方 的 模块 都 使 用 到 了 EventEmitter。 在 第 4 章 中 ， 
我 会 描述 如 何 将 示例 3-13 的 代码 转换 成 一 个 模块 。 
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第 4 章 


Node 模块 系统 


开发 人 员 在 实现 Node 的 基本 功能 的 时 候 尽 量 进行 了 简化 ， 通 过 Node 模块 提供 其 
他 扩展 的 功能 ， 而 不 是 将 每 个 可 能 用 到 的 组 件 都 直接 集成 在 Node 中 。 


Node 模块 系统 (Node Module System ) 以 CommonJS 模块 系统 为 模式 。CommonJS 
模块 可 以 创建 互相 兼容 的 模块 。Node 模块 系统 的 关键 在 于 向 开发 人 员 保 证 了 他 们 
的 模块 可 以 和 其 他 模块 一 起 工作 。 


Node 模块 需要 实现 CommonJS 模块 系统 的 以 下 需求 : 

1. 支持 require 方法 ， 接 收 模块 标识 作为 参数 返回 可 用 的 API; 
2. 模块 名 称 是 字符 串 ， 可 能 包含 斜 杠 ( 指 代 路 径 ); 

3. 模块 必须 明确 指出 需要 对 外 暴露 的 接口 ; 

4. 模块 的 变量 都 是 私有 的 。 

在 之 后 几 个 章节 中 ,我 们 会 了 解 Node 是 如 何 实现 这 些 需求 的 。 


4.1 使 用 require 和 默认 路 径 加 载 模块 
Node 支持 简单 的 模块 加 载 系 统 : 文件 和 模块 间 具 有 一 一 对 应 的 关系 。 
在 Node 应 用 中 引入 模块 , 需要 使 用 require 语句 , 传人 参数 为 代表 模块 标识 符 的 字符 串 : 


var http = require ('http'); 


还 可 以 引入 模块 中 的 特定 对 象 ， 而 不 是 整个 模块 : 
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var spawn = require ('child process') .spawn; 


你 可 以 用 模块 标识 符 加 载 Node 原生 模块 或 者 node modules 文件 夹 中 的 模块 ,比如 

FIFE http 代表 HTTP 模块 ,对 于 非 Node 原生 支持 和 不 在 node modules 文件 夹 里 

的 模块 ， 雷 要 在 字符 串 之 前 加 上 相对 路 冬 (和 斜 杜 “/” 表 示 )。 例 如 ，Node 想 引 入 

名 为 mymodule.js 的 模块 , mymodule.js 与 Node 应 用 在 同一 目录 下 ,require 语句 为 : 
require ('./mymodule.js'); 

或 者 可 以 使 用 绝对 路 径 : 


require ('/home/myname/myapp/mymodule.js'); 
模块 文件 的 扩展 名 可 以 为 js，.node 或 者 .json。.node 扩展 名 表示 编 详 好 的 二 进 制 文 
件 ， 而 不 是 包含 JavaScript 的 文本 文件 。 
Node 核心 模块 的 优先 级 要 高 于 外 部 模块 。 当 你 尝试 加 载 一 个 日 定义 的 http 模块 ， 
Node 会 首先 加 载 内 部 核心 HTTP 横 块 ， 除 非 你 换个 模块 名 字 或 者 提供 绝对 路 径 。 
之 前 我 曾 提 到 node modules 文件 夹 。 如 果 提 供 的 模块 名 没有 包含 路 径 信 息 ， 或 者 
该 模块 不 是 核心 模块 ，Node 首先 根据 当前 工程 在 node modules 文件 夹 中 查找 。 如 
果 在 该 文件 夹 中 没 找到 该 模块 ， 就 会 到 该 文件 夹 的 父 上 日 录 进 行 查找 ， 以 此 类 推 。 
如 果 模 块 名 为 mymodule, 应 用 程序 在 /home/myname/myprojects/myapp 的 子 目录 中 。 
Node 会 依次 按照 以 下 次 序 进行 查找 : 
e /home/myname/myprojects/myapp/node modules/mymodule.js 
e /home/myname/myprojects/node_modules/mymodule.js 
e /home/myname/node_ modules/mymodule.js 
e /node modules/mymodule.js 
Node 可 以 根据 文件 在 哪里 声明 require 语句 来 优化 查找 。 比 如 ， 如 果 调 用 require 
语句 的 文件 本 身 就 是 node_modules 文件 夹 某 个 子 日 录 中 的 一 个 模块 ，Node 就 会 从 
最 高 层 的 node_modules 文件 夹 中 开始 搜索 被 引用 的 模块 。 
require 还 有 其 他 两 种 形式 : require.resolve 和 require.cache。 require.resolve 方法 负责 
查找 给 定 的 模块 但 是 并 不 加 载 该 模块 ， 只 返回 文件 名 。require.cache 对 象 包含 所 有 
加 载 模块 的 缓存 版 本 。 当 你 在 相同 语 培 中 再次 加 载 同 一 模块 时 ，Node 会 选择 从 
cache 中 加 载 该 模块 来 优化 性 能 。 如 果 需 要 强制 重新 加 载 某 个 cache 中 的 模块 ， 先 


从 cache 中 删除 该 模块 然后 重新 加 载 。 
如 来 引用 菏 块 路 符 为 : 

var circle=require('./circle.js'); 
删除 模块 命令 : 

delete require.cache('./circle.js'); 


该 命令 使 得 下 次 调用 require 的 时 候 会 重新 加 载 该 模块 。 


4.2 ”外 部 模块 和 Node 包 管 理工 具 


正如 之 前 提 到 过 的 , Node 庞大 的 功能 库 很 多 都 是 由 第 二 方 模块 提供 的 。 比 如 路 由 模块 、 
与 文档 数据 库 系统 交互 的 模块 、 模 版 模块 、 测 试 模块 ， 偿 有 支付 网 关 相关 的 模块 。 


尽管 没有 官方 的 Node 模块 开发 系统 ， 开 发 人 员 们 还 是 很 热 袁 于 将 自己 的 模块 上 传 
到 github 上 。 以 下 是 一 些 稼 用 的 查找 Node 模块 的 软件 源 : 


e npm registry (http://search.npmjs.org/) 

e Node module wiki(https://github.com/joyent/node/wiki/modules) 
e The node-toolbox(http://toolbox.no.de/) 

e Nipster!(http://eirikb.github.com/nipster/) 


模块 被 大 致 分 门 别 类 为 不 同 的 类 型 ， 比 如 之 前 提 及 的 路 由 模块 、 数 据 库 、 模 版、 支 
付 网 关 等 。 


你 需要 从 GitHub ( 或 者 其 他 源 ) 下 载 模块 源码 ， 安 装 到 你 的 应 用 环境 ， 然 后 才 可 
以 使 用 该 模块 。 绝 大 部 分 模块 提供 了 基本 的 安装 说 明 , 至 少 也 可 以 从 模块 的 文件 和 
目录 中 找到 安 衣 方法 。 然 而， 更 简单 的 安装 模块 的 方法 是 : 使 用 Node 包 管理 工具 
(Node Package Manager, 简称 npm， 后 文 都 使 用 npm 表示 )。 


提示 

npm 官网 为 : http://npmjs.org/。 可 以 在 http://npmjs.org/doc/README. html 
找到 npm 的 简介 。 对 Node 模块 开发 人 员 来 说 ， 深 入 理解 Node 的 内 
ZE npm 手册 的 开发 者 章节 :http://npmjs.org/doc/developers.html, 关于 
解释 本 地 和 全 局 安装 的 差异 ， 参 考 : http://blog.nodejs.org/2011/03/23/ 
npm-1-0-global-vs-local-installation/. 
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安装 好 npm Ja, 在 与 访问 Node 相同 的 环境 中 , 可 以 在 命令 行 输入 npm 来 确保 npm 
是 否 安装 成 功 。 


用 以 下 命令 可 以 查看 npm 全 部 命令 列表 : 
Snpm help npm 


安装 模块 时 可 以 选择 局 部 或 者 全 局 安装 模块 。 如果 你 工作 的 项 目 并 不 是 共用 该 系统 
的 每 个 人 都 需要 访问 该 模块 , 那么 局 部 安装 是 最 好 的 实现 方式 。 默认 安 装 方式 为 局 
ait, HKRX node modules. 


Snpm install modulename 
例如 ， 安 装 一 个 非常 流行 的 中 间 件 架构 Connect: 
Snpm install connect 
npm 不 只 安装 Connect 本 身 ， 并 且 也 安装 Connect 依赖 的 模块 ， 如 图 4-1 所 示 。 


一 旦 安装 完毕 ， 就 可 以 在 本 地 node modules 目录 中 找到 该 模块 。 相 关 的 依赖 都 被 
安装 在 该 模块 的 node modules 目录 中 。 


如 果 想 要 全 局 安装 ， 使 用 -g 或 者 --global 选项 : 
Snpm-g install connect 


以 上 例子 安装 的 模块 都 在 npm 观望 中 。 同 样 也 可 以 安装 本 地 文件 系统 中 的 模块 ， 
或 者 来 自 本 地 或 者 url 得 到 的 压缩 文件 : 


npm install http://somecompany.com/somemodule.tgz 


如 果 安 装 包 有 版 本 号 需要 指定 具体 的 版 本 : 


npm install modulename@0.1 


wa 提示 
npm 也 可 以 和 Git 一 起 使 用 ， 附 录 中 有 说 明 。 


还 可 以 通过 这 种 方式 安装 我 们 非常 熟悉 的 包 ，jQuery: 
npm install jquery 


现在 在 Node 应 用 开发 中 你 可 以 使 用 熟悉 的 $ 语 法 了 。 
如 果 你 不 再 需要 一 个 模块 ， 可 以 印 载 : 
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npm uninstall modulename 
下 一 行 命令 告知 npm 检查 新 的 模块 ， 如 果 存 在 的 话 对 其 进行 更 新 : 
npm update 
也 可 以 更 新 单个 模块 . 
npm update modulename 
如 果 只 是 希望 查看 是 否 有 过 期 的 包 ， 命 令 为 : 
npm outdated 
同样 这 个 命令 也 可 以 对 单一 模块 执行 。 
显示 安装 的 包 和 依赖 命令 为 : list，ls，la 或 者 11: 
npm ls 


la 和 直选 项 提供 了 更 多 的 描述 。 以 下 内 容 是 我 在 Windows 7 机 右上 运行 npmll 的 结果 : 


C:\Users\Shelley>npm ls 11 
npm WARN jsdom >= 0.2.0 Unmet dependency in C:\Users\Shelley\node_modules\htm15 
C:\Users\Shelley 
| 一 async@0.1.15 
| 一 colors@0.6.0-1 
| 一 commander@0.5.2 
上 一 connect@1.8.5 
| 上 一 formidable@1.0.8 
| 上 一 mime@1.2.4 
| — qs60.4.1 
r htmls5@vo.3.5 
-一 UNMET DEPENDENCY jsdom >= 0.2.0 
上 一 opts@1.2.2 
-一 tap@0.0.13 

| 一 inherits@1.0.0 

| 一 tap-assert@0.0.10 
tap-consumer@0.0.1 
tap-global-harness@0.0.1 
tap-harness@0.0.3 
tap-producer@0.0.1 
tap-results@0.0.2 
tap-runner@0.0.7 
| 一 inherits@1.0.0 

slide@1.1.3 
tap-assert@0.0.10 


| 一 
| 一 
|— tap-consumer@0.0.1 
| 一 
|. 


See aE 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


tap-producer@0.0.1 
tap-results@0.0.2 


| L— yamlish@0.0.3 
| | 一 tap-test@0.0.2 
| 上 yamlish@o.0.2 
L_. optimist@0.3.1 

L— wordwrap@0.0.2 
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ER Command Prompt 





Specify configs in the ini-formatted file: 
C:\Users\She lle y\ .npmrec 

or on the command line via: npm <command> ——key value 

w info can be viewed via: npm help config 


pmn@1.1.4-3 C:\Program Files (x86>)\nodejs\node_modules\npm 


einen Lista e Js>npm faq 
pening HTML in default browser. 





=\Users\She lle y\Documents\Research\node. j pm install connect 











4-1 ”在 Windows7 系统 中 通过 npm 安装 Connect 


注意 到 关于 HTMLS 模块 的 一 个 unmet dependency ( 未 解决 的 依赖 )。HTMLS 模块 
需要 一 个 较 早 版 本 的 JSDOM 库 。 修 复 这 一 问题 ， 需 手动 安装 该 模块 需要 的 版 本 : 


npm install jsdom@0.2.0 


也 可 以 直接 用 -d 标识 安装 所 有 的 依赖 。 比 如 ， 在 模块 的 目录 中 输入 


npm install -d 


如 果 你 需要 安装 的 模块 版 本 还 没有 上 传 到 npm registry, 可 以 直接 从 Git 目录 安装 : 


npm install https://github.com/visionmedia/express/tarball/master 


关于 这 一 点 务必 要 格外 谨慎 。 因 为 我 发 现 当 你 安装 一 个 该 版 本 尚未 发 布 的 模块 ,又 
使 用 了 npm update 进行 升级 后 ，npm registry 版 本 会 覆盖 当前 你 使 用 的 版 本 。 


查看 当前 全 局 安装 的 模块 ， 命 令 是 : 


npm ls -g 


你 可 以 用 config 命令 学 习 更 多 关于 npm 的 安装 。 以 下 命令 显示 npm 的 配置 设置 : 


npm config list 
更 深入 的 了 解 配 置 的 设置 ， 使 用 : 


npm config ls -1 
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可 以 用 命令 行 来 修改 或 者 删除 配置 项 : 


npm config delete keyname 
npm condig set keyname value 


或 者 直接 编辑 配置 文件 : 


$ npm config edit 


Be He 

aAa 
-S 我 强烈 建议 不 要 修改 npm 的 配置 ， 除 非 你 非常 了 解 该 修改 可 能 带 来 
的 所 有 影响 。 


搜索 模块 时 ， 可 以 挑选 合适 的 关键 字 ， 从 而 返回 最 符合 你 需求 的 搜索 结 来 : 





npm search html5 parser 


当 你 第 一 次 搜索 时 ,npm 会 建立 一 个 索引 , 这 需要 花费 几 分 钟 的 时 间 。 当 搜索 结束 
时 ， 你 会 得 到 一 系列 符合 搜索 条 件 或 者 关键 字 的 模块 列表 。html5 和 parser 只 返回 
了 两 个 模块 : HTML5 和 支持 SVG 、MathML 的 HTML parser, 支持 HTML Canvas、 
SVG-to-Canvas parser 的 对 象 模块 Fabric。 


npm 官网 提供 了 可 供 浏 览 的 模块 注册 表 ， 还 有 当前 引用 最 多 的 模块 列表 显示 被 
Node 应 用 模块 引用 最 多 的 模块 。 在 下 一 节 中 ， 会 涉及 部 分 这 类 模块 。 

提示 

我 会 在 本 章 稍 后 4.4 节 介 绍 其 他 npm 的 命令 。 





4.3 ”如 何 找到 你 需要 的 模块 

尽管 Node js 是 近 几 年 才 流 行 起 来 的 , 但 是 已 经 拥有 了 大 量 用户 。 当 你 浏览 Node.js 
的 wiki 页 面 时 ， 会 发 现 非 常 多 的 模块 。 好 处 在 于 你 可 以 找到 很 多 有 用 的 模块 来 实 
现 你 需要 的 功能 ,但 是 随 之 而 来 的 坏处 在 于 很 难 决 定 需要 使 用 哪个 模块 , 换 句 话说 ， 
很 难 决定 哪个 模块 是 “最 佳 选 项 ”。 

哪个 模块 最 受 欢迎 ,使 用 类 似 Google 等 搜索 工具 可 以 提供 一 个 相对 公平 的 观点 。 
比如 , 当 我 搜索 中 间 件 和 架构 模块 的 时 候 很 明显 Connect 和 Express 是 最 党 欢迎 的 。 
还 有 ， 当 你 在 GitHub 注册 表 中 查找 某 个 模块 时 ， 可 以 看 到 该 模块 是 否 拥有 大 量 文 
持 者 、 是 和 否 更 新 及 时 且 兼 容 当 前 Node 安装 包 。 作为 男 一 个 例子 , REA I Apricot. 
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Apricot 是 一 个 HTML 解析 的 工具 ， 在 Node 文档 中 也 有 推荐 。 但 是 我 注意 到 这 个 
模块 已 经 很 久 没 有 更 新 过 了 ， 当 尝试 使 用 该 模块 的 时 候 ， 发 现 它 无 法 与 我 的 Node 
RE (ED, FER ASSAY IN TBE )。 

提示 

很 多 模块 都 提供 了 应 用 范例 ， 以 及 一 系列 能 够 快速 让 你 知道 该 模块 能 
否 在 你 的 环境 中 工作 的 测试 。 





正如 之 前 提 到 的 ，Node 官方 文档 提供 了 推荐 的 第 三 方 模块 的 列表 ， 以 npm 为 例 ， 
RIA npm 现在 已 经 集成 在 Node KAP. 但 是 , npm 网 站 和 它 的 模块 注册 表 提 
供 了 更 好 的 服务 ， 显 示 当 前 大 部 分 应 用 中 使 用 的 模块 。 


在 npm 注册 页 面 ， 可 以 搜索 模块 ， 也 可 以 查看 “最 常用 依赖 ”模块 的 列表 ， 包 括 
在 其 他 模块 中 引用 或 者 Node 应 用 中 使 用 的 模块 。 在 写 这 本 书 的 时 候 ， 排 名 靠 前 的 
模块 为 : 


Underscore 

提供 普遍 使 用 的 JavaScript 函数 。 
Coffee-script 

可 以 使 用 CoffeeScript。CoffeeScript 是 一 种 可 以 编译 为 JavaScript 的 语言 。 
Request 

简化 的 HTTP 请 求 客户 端 。 
Express 

一 种 染 构 。 
Optimist 

提供 轻 量 级 的 选项 解析 。 
Async 

提供 方法 和 模式 同步 代码 。 
Connect 


中 间 件 。 
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Colors 
为 控制 台 添加 颜色 。 
Uglify-js 
解析 器 和 压缩 器 /或 者 美化 工具 。 
Socket.10 
客户 端 /服务 器 通信 。 
Redis 
Redis & F? ii o 
Jade 
一 个 模版 引擎 。 
Commander 
命令 行程 序 使 用 。 
Mime 
提供 对 文件 扩展 名 的 支持 和 MIME 映射 。 
JSDOM 
实现 W3C DOM. 


在 以 后 的 章节 中 会 涉及 这 些 模 块 , 但 是 现在 介绍 三 个 一 一 因为 这 三 个 模块 不 仅 可 以 
帮助 我 们 更 好 地 理解 Node 工作 原理 ， 而 且 模 块 本 身 也 非常 有 用 : 


e Colors 
e Optimist 


e Underscore 


4.3.1 Colors: 简单 至 上 
Colors 是 一 个 很 简单 的 模块 ,可 以 给 console.log 输出 提供 不 同 的 颜色 以 及 风格 , 这 
基本 是 它 全 部 的 功能 。 但 是 , 它 也 很 好 地 说 明了 什么 样 是 一 个 高 效 的 模块 : 使 用 简 
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单 ， 提 供 单 一 的 功能 并 且 完 成 得 很 完美 。 
测试 模块 是 否 正 常 工作 是 使 用 REPL 的 一 个 重要 原因 。 为 了 测试 Colors, 用 npm 
WR: 

$ npm install colors 
新 建 一 个 REPL 会 话 ， 引 入 colors 库 : 

>var colors = require('colors'); 
因为 Colors 模块 包含 在 当前 路 径 的 node modules 目录 中 ,因此 Node 加 载 速 度 非 常 快 。 
现在 进行 测试 ， 例 如 : 

console.log('This Node kicks it! '.rainbow.underline); 


输出 信息 是 彩色 的 , 并 且 市 下 划 线 。 样 式 只 对 一 个 信息 有 效 ， 你 需要 对 男 一 个 信息 
重新 添加 样式 。 


如 果 你 使 用 过 jQuery, 你 会 发 现 可 以 使 用 链 式 调 用 来 组 合 不 同 的 效果 。 该 例子 有 两 
个 效果 : 字体 效果 一 一 下 划 线 ， 以 及 字体 颜色 一 一 彩虹 色 。 


尝试 下 zebra 和 bold: 





console.log('We be Nodin' .zebra.bold); 


你 可 以 对 console 信息 的 不 同 部 分 进行 不 同 的 样式 修改 : 


console.log('rainbow'.rainbow, 'zebra'.zebra); 


为 什么 像 Colors 这 样 的 模块 很 有 用 呢 ? 一 个 解释 是 ， 它 可 以 使 我 们 对 不 同事 件 定 
制 不 同 的 样式 ， 比 如 对 一 个 模块 的 中 的 错误 显示 一 种 颜色 , 第 二 个 模块 中 的 警告 用 
另 一 个 颜色 等 。 为 了 实现 这 种 功能 ， 你 可 以 使 用 Colors 的 预先 设置 或 者 创建 自己 
的 主题 : 


>colors.setTheme ( { 

nee -modl_warn: 'cyan', 

sce’ .mdl error: '‘'red', 

scaled .md2 note: ‘'yellow' 

POOR ee 

>console.log("This is a helpful message".mod2_note) ; 
This is a helpful message 

>console.log("This is a a bad message".modl_error); 
This is a bad message 
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r 提示 
更 多 关于 Colors， 参 考 : https://github.com/Marak/colors.js。 


4.3.2 Optimist. 另 一 个 简单 的 小 模块 
Optimist 是 我 们 接 下 来 要 介绍 的 专注 于 解决 某 个 具体 问题 的 模块 。 它 的 全 部 功能 就 
是 解析 命令 中 的 选项 参数 ， 虽 然 简单 ， 但 是 功能 很 强大 而 且 完 备 。 
例如 ， 以 下 代码 利用 Optimist 模块 输出 命令 行 选项 : 
ł!/usr/local/bin/node 


var argv = require ('optimist').argv; 
console.log (argv.o + "" + argv.t); 


可 以 用 几 个 选项 测试 该 段 代 人 码 。 以 下 这 段 代 人 码 在 控制 台中 打印 出 1 和 2 的 值 : 
./app.js -o 1 -t 2 

同样 的 方法 也 可 以 处 理 长 选项 : 
#! /usr/local/bin/node 


var argv = require('optimist').argv; 
console.log('argv.one + ""' + argv.two); 


测试 代码 如 下 ， 打 印 出 My Name: 


./app2.js -one="My"--two="Name" 


这 样 的 方法 还 可 以 处 理 布尔 值 和 未 加 连 字 号 的 选项 。 


oe 提示 
更 多 关于 Optimist 参考 : https://github.com/substack/node-optimist. 


按 独立 应 用 程序 方式 运行 Node 应 用 
本 书 中 的 绝 大 多 数 例子 都 用 如 下 语法 运行 : 


node appname.js 


然后 ， 对 Node 应 用 程序 文件 做 出 一 些 修 改 ， 就 可 以 作为 独立 应 用 程序 运行 。 
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首先 ， 在 程序 文件 第 一 行 加 入 以 下 代码 : 


#! /usr/local/bin/node 


该 路 径 为 Node 的 安装 路 径 。 
接 下 来 ,修改 该 文件 的 权限 : 


chmod a+x appname.js 


然后 就 可 以 运行 了 : 





./appname.js 


4.3.3 Underscore 
安装 Underscore 模块 : 


npm install underscore 


根据 开发 人 员 的 描述 ，Underscore 模块 是 Node 主要 支柱 之 一 。Underscore 提供 了 
很 多 用 于 第 三 方 库 的 JavaScript 扩展 功能 ， 比 如 jQuery 或 者 Prototype.js。 


类 似 于 jQuery 的 $ 符 号 , 用 下 划 线 (_) 可 以 访问 Underscore Æ Phi, Underscore 因此 
而 得 名 。 例 如 : 


var _ = require('underscore'); 
_.each(['apple', ‘'cherry'], function(fruit) { console.log(fruit) }); 


上 述 例 子 的 一 个 问题 在 于 下 划 线 在 REPL 中 有 特殊 的 含义 。 不 过 不 必 担 心 , 我 们 可 
以 使 用 另 一 个 变量 us 代替 : 


var us = require('underscore'); 
us.each(['apple', ‘cherry'], function(fruit) { console.log(friut) }); 


Underscore E4 F XAH. EG. RAA WR. BEL, URAC OREND ED 
能 。 幸运 的 是 ， 由 于 Underscore 有 完善 的 文档 来 说 明 其 全 部 功能 , 所 以 我 在 这 里 不 
对 其 功能 的 细 市 深入 摘 述 了 。 


唯一 一 个 需要 特别 提 一 下 的 功能 是 : 可 以 通过 mixin 方法 用 你 自己 的 函数 扩展 
Underscore 的 功能 。 在 REPL 中 可 以 快速 体验 一 下 : 

>var us = require('underscore'); 

undefined 


>us.mixin ({ 
.betterWithNode: function(str) { 
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fares return str + 'is better with node'; 


>console.log(us.betterWithNode('chocolate')); 
chocolate is better with Node 


# 提示 
在 很 多 Node 模块 中 都 可 以 看 到 mixin 这 个 单词 。 它 基于 一 种 模式 ， 
a 一 个 对 象 的 属性 可 以 添加 到 ("mixed in") 另 一 个 对 象 中 。 


当然 ， 从 应 用 角度 来 说 ， 从 一 个 可 重用 的 模块 扩展 Underscore 模块 更 有 意义 。 这 就 
是 下 一 节 即 将 介绍 的 内 容 一 一 创建 目 定 义 模块 。 


4.4 创建 目 定 义 模块 


正如 在 客户 问 JavaScript 中 所 做 的 一 样 ， 你 希望 将 可 重用 的 JavaScript 分 离 出 来 作 
为 库 文件 。 将 JavaScript 库 文 件 转换 成 为 Node 可 用 的 模块 只 需要 多 做 几 个 步骤 。 


假设 有 一 个 JavaScript 库 函 数 一 一 concatArray， 接 收 string 和 string 数组 作为 参数 ， 
并 将 第 一 个 string 拼接 到 数组 中 的 每 一 个 string E: 


function cancatArray(str, array) { 
return array.map(function(element) { 
return str + '' + element; 
} ) ; 
} 


接 下 来 ,你 希望 可 以 在 Node 应 用 程序 中 像 其 他 函数 一 样 使 用 该 郴 数 。 


将 JavaScript JE KAEA Node 可 用 的 模块 , 需要 用 exports 对 象 将 所 有 需要 暴露 
给 外 部 使 用 的 函数 导出 ， 如 下 代码 所 示 : 





exports.concatArray = function(str, array) { 
return array.map(function(element) { 
return str + '' + element; 


Ee 
}? 


在 Node 应 用 程序 中 使 用 concatArray, 需要 先 用 require 导 人 该 库 文件 , 并 将 require 
语句 赋值 给 一 个 变量 。 完 成 之 后 ， 你 就 可 以 调用 代码 中 暴露 的 任何 函数 : 


Var newArray = require('./arrayfunctions.js'); 
console.log(newArray.concatArray('hello', ['testl', 'test2'])); 
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这 个 过 程 并 不 复杂 ， 只 需要 记 住 以 下 两 件 事情 : 
1. 使 用 exports 对 和 象 将 函数 暴露 给 外 部 可 用 ; 


2. 将 库 文件 作为 一 个 简单 的 导入 对 象 ， 赋 值 给 变量 。 就 可 以 通过 变量 访问 接口 


4.4.1 打包 整个 目录 
你 可 以 将 你 的 模块 分 解 为 独立 的 JavaScript 文件 放 在 同一 个 目录 中 。 以 下 有 两 种 方 
式 组 织 文件 内 容 以 便于 Node 加 载 整 个 日 录 。 


第 一 种 方法 : 提供 一 个 名 为 package.json 的 JSON 文件 ， 该 文件 包含 日 录 信 息 。 文 


件 结构 中 可 以 包含 其 他 信息 ,但 是 与 Node 相关 的 接口 为 : 
{ "name": “mylibrary", 
"main": "./mymodule/mylibrary.js" } 


第 一 个 属性 name 是 指 module 的 名 字 。 第 二 个 属性 main 是 指 模块 的 人口 。 
第 二 种 方法 : 在 该 目录 中 引入 index.js 或 者 index.node 作为 模块 的 主人 口 。 


你 可 能 会 问 为 什么 提供 一 个 目录 而 不 是 一 个 简单 的 模块 呢 ? 很 大 一 部 分 原因 是 因 
为 你 在 使 用 现 有 的 JavaScript 库 ,只 需要 用 exports 提供 打包 文件 就 可 以 对 所 有 需要 
使 用 的 因数 打包 。 兄 一 个 原因 是 库 文 件 很 大 ， 需 要 分 解 以 便于 修改 。 

不 管 是 什么 原因 ， 需 要 知道 的 是 所 有 导出 的 对 象 都 必须 在 同一 个 Node 加 载 的 那个 
主要 文件 中 。 


4.4.2 为 你 的 模块 发 布 做 准备 

如 果 你 希望 别人 也 可 以 使 用 你 的 模块 , 你 可 以 将 它 放 在 自己 的 网 站 上 , 但 是 这 样 你 
会 损失 一 大 批 用 户 。 当 你 准备 好 发 布 一 个 模块 的 时 候 ， 你 需要 将 它 添加 到 Node js 
官网 的 模块 列表 中 和 npm 注册 表 中 。 


之 前 曾 提 到 的 package.json 文件 ， 它 是 基于 CommonJS 模块 系统 建议 的 ， 可 参考 . 
http://wiki.commonjs.org/wiki/Packages/1.0#Package Descriptor File ( 可 查看 是 否 有 
更 新 的 版 本 )。 


package.json 文件 需要 的 属性 : 


name. 
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包 的 名 子 。 


description: 
包 的 描述 信息 。 
version: 


符合 版 本 要 求 的 当前 版 本 信息 。 
maintainers : 

包 维 护 信 息 的 数组 (包括 名 字 ， 邮 箱 和 网 站 )。 
contributors: 

包 作 者 信息 的 数组 (包括 名 字 ， 邮 箱 和 网 站 )。 
bugs: 

用 于 提交 Bugs 的 URL。 
licenses: 

licenses 的 数组 。 
repositories : 

可 以 找到 该 包 的 地 址 目录 组 成 的 数组 。 
dependencies : 

必要 的 包 及 其 版 本 号 。 


其 他 还 有 很 多 的 属性 , 但 是 它们 都 是 可 选 的 。 多 亏 了 npm, 我 们 可 以 更 容易 的 创建 
这 个 文件 。 如 果 在 命令 行 中 输入 以 下 命令 : 
npm init 

会 遍历 所 有 需要 的 属性 ， 依 次 提示 你 完成 输入 。 全 部 输入 完成 时 ,会 生成 
package.json 文件 。 

在 第 3 章 示 例 3-13 中 ， 创 建 了 一 个 叫做 inputChecker 的 对 象 ， 检 查 传递 给 命令 的 
数据 并 执行 命令 。 这 个 示例 介绍 了 如 何 兼 容 EventEmitter。 现 在 来 修改 这 个 简单 的 
对 象 ， 使 它 可 以 被 其 他 应 用 或 者 模块 重用 。 
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首先 , 在 node_modules 路 径 下 创建 一 个 子 目 录 ,， 命名 为 inputcheck。 然 后 把 现 有 的 
inputChecker 代码 放 进 去 ， 需 要 重 命 名 该 文件 为 index.js。 接 下 来 ,修改 代码 ,抽出 
实现 该 对 象 的 部 分 ， 将 这 部 分 存储 为 测试 文件 。 最 后 需要 做 的 修改 是 添加 exports 
对 象 ， 代 码 如 如 例 4-1 所 示 。 


示例 4-1 将 示例 3-13 中 的 代码 修改 为 一 个 模块 对 象 
var util = require('util'); 
var eventEmitter = require('events').EventEmitter; 
var fs = require('fs'); 


exports.inputChecker = inputChecker; 


function inputChecker(name, file) { 


this.name = name; 
this.writeStream = fs.createWriteStream('./ ' + file + '/txt', 
{ "flags' : 'a', 
'encoding' : 'utf8', 


'mode' : 0666 }); 
}; 


util.inherits(inputChecker, eventEmitter) ; 


inputChecker.prototype.check = function check(input) { 
var self = this; 


var command = input.toString().trim().substr(0,3); 


if (command == ‘'wr') { 

self.emit('write', input.substr(3, input.length) ); 
} else if (command == ‘en;"') { 

self.emit('end'); 
} else { 


self.emit('echo', input); 
} 
}; 


我 们 没 办 法 直接 返回 对 象 的 方法 , 因为 util.inherits 期 望 在 inputChecker 文件 中 存在 
一 个 对 象 ， 之 后 会 在 文件 中 修改 inputChecker 对 象 的 原型 (prototype ) 方法 。 使 用 
exporst.inputChecker 修改 代码 是 可 以 的 , 这 和 单独 赋值 给 对 象 一 样 简单 , 但 这 并 不 
是 标准 的 做 法 。 


一 一 


运行 npminit 并 回答 每 一 个 提示 问题 来 创建 package.json 文件 。 该 文件 如 示例 4-2 所 示 。 


示例 4-2 为 inputChecker 模块 生成 package.json 文件 


{ 


"author": "Shelley Powers <shelleyp@burningbird.net> (http://burningbird.net) ", 
"name": "inputcheck", 


"description": "Looks for commands within the string and implements the commands", 
"version": "0.0.1", 
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"homepage": "http://inputcheck.burningbird.net" 


"repository": { 
"ares. T 
by 
"main": “anputcheck. 7s", 
"engines": { 


"node": "~0.6.10" 
Fz 
"dependencies": {}, 
"devDependencies": {}, 
"optionalDependencies": {} 


} 


npminit 命令 并 不 提示 关于 dependencies 的 内 容 ， 所 以 需要 直接 添加 在 该 文件 中 。 
在 本 例 中 ，inputChecker 模块 并 不 依赖 其 他 任何 外 部 模块 ， 所 以 这 部 分 可 以 不 添加 
任何 内 容 。 


提示 


第 16 章 会 对 package.json 文件 进行 更 深入 的 介绍 。 





现在 , 我 们 可 以 测试 这 个 新 模块 确保 它 作 为 模块 使 用 时 的 功能 正常 。 示 例 4-3 是 之 
前 inputChecker 应 用 中 测试 新 对 象 的 部 分 ， 被 抽出 来 作为 独立 的 测试 应 用 。 


示例 4-3 InputChecker 测试 程序 
Var inputChecker = require('inputcheck') .inputChecker; 


// 测 试 新 对 象 和 事件 处 理 


var ic = new inputChecker('Shelley', 'output'); 


ic.on('write', function(data) { 
this.writeStream.write(data, '‘utf8"'); 


DE 


ic.addListener('echo', function( data) { 
console.log(this.name + ' wrote ' + data); 


} ) ; 


ic.on(‘'end’, function() { 
process.exit(); 


}); 


process.stdin.resume(); 

process.stdin.setEncoding('utf8'); 

process.stdin.on('data', function(input) { 
ic.check (input) ; 


1)? 
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现在 在 模块 目录 中 新 建 一 个 example 目录 ， 将 测试 代 人 而 复制 进去 ， 作 为 例子 与 
模块 一 起 打包 。 好 的 实践 要 求 我 们 不 仅 需要 提供 test 目录 ， 包 含 一 个 或 者 多 个 
测试 应 用 ， 还 需要 doc 目录 ， 包 含 关 于 模块 的 说 明文 档 。 像 inputChecker 这 样 
的 小 模块 ，README 文件 应 该 足够 了 了。 最 后 ， 我 们 创建 模块 gzipped tarball JE 
缩 文 件 。 


当 我 们 准备 好 所 有 需要 的 东西 以 后 ， 就 可 以 发 布 该 模块 了 。 
4.4.3 ”发布 模块 


给 我 们 市 来 npm 的 人 同样 也 为 Node 开发 人 员 提 供 了 非常 棒 的 开源 资源 : 开发 人 员 指 
导 (the Developer Guide )。 它 列 出 了 所 有 我 们 需要 知道 的 关于 如 何 发 布 模块 的 内 容 。 
指导 文件 详细 说 明了 一 些 对 package.json 文件 的 附加 要 求 。 在 已 创建 的 现 有 属性 的 


技术 上 , 需要 添加 directories 属性 , 值 为 目录 与 路 径 的 哈 厦 表 , 比如 之 前 提 到 的 test 
和 doc: 


"directories" : { 
"doc" 。 ' nz 
"test" : "test", 
"example" : "examples" 


} 


在 发 布 前 , 指导 文件 建议 测试 模块 是 否 可 以 完全 安装 。 在 模块 根 目 录 下 输入 以 下 命 
令 进行 测试 : 


npm install . -g 


截至 此 时 ,已 经 测试 了 inputChecker 模块 ， 修 改过 package.json 文件 添加 新 的 
directories 属性 ， 并 确认 了 模块 可 以 成 功 安 疫 。 


接 下 来 ， 需 要 将 目 己 添加 为 npm 用 户 。 命 令 : 
npm adduser 
然后 根据 提示 输入 用 户 名 ， 密 码 以 及 邮箱 地 址 。 
最 后 一 件 需 要 做 的 事情 是 : 
npm publish 


可 以 提供 tarball 或 者 目录 的 地 址 。 指 导 文 件 中 提示 过 ， 除 非 在 package.json 文件 中 
用 .npmignore 指定 忽略 某 些 内 容 , 否则 目录 中 的 任何 内 容 都 会 被 骏 露 给 用 户 。 所 以 ， 
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在 发 布 之 前 最 好 将 不 必要 的 东西 删除 。 


一 旦 模块 发 布 并 且 代 码 上 传 到 GitHub ( 如 果 这 是 你 使 用 的 管理 代码 的 工具 )， 该 模 
块 就 可 以 被 其 他 用 户 使 用 了 。 你 可 以 通过 Twitter、Google+、Facebook、 个 人 网 站 ， 
或 者 其 他 任何 你 觉得 人 们 可 以 了 解 该 模块 信息 的 方式 进行 推广 。 这 种 推广 并 不 是 自 
RKE, Me RR o 
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第 5 章 
控制 流 、 异步 模式 和 异常 处 理 


在 了 解 了 Node 的 异步 事件 、 回 调 盟 数 以 及 一 些 如 EventEmitter 的 新 对 象 后 , 或 许 会 让 
你 觉得 想 学 好 Node 不 是 那么 容易 ， 更 不 用 说 之 后 的 一 些 服务 端 功 能 了 。 但 是 ， 如 果 
你 之 前 使 用 过 任何 现代 a 库 ， 或 者 已 经 练习 并 使 用 了 本 章节 之 前 提 及 的 一 些 
Node 功能 的 话 ， 那 么 其 实 你 已 经 接触 过 异步 模式 开发 了 。 


举例 来 说 ， 当 你 在 JavaScript 中 使 用 计时 右 时 ， 就 代表 你 已 经 使 用 了 异步 功能 。 如 
果 你 曾经 使 用 过 Ajax 进行 开发 ， 你 同样 也 接触 到 了 异步 函数 。 即 使 是 普通 又 古老 
的 onclick 事件 处 理 程序 也 是 一 个 异步 清 数 ， 因 为 我 们 永远 也 不 会 知道 用 户 什 么 时 
候 点 击 鼠 标 或 散 击 键盘 。 


任何 等 待 某 个 事件 发 生 , 或 者 等 竺 处 理 完 成 以 便 得 到 结果 , 同时 又 不 会 阻塞 控制 线 
程 执行 的 方法 ， 就 是 一 个 异步 困 数 。 在 应 用 程序 进入 onclick 事件 处 理 函 数 前 ， 也 
就 是 等 待 用户 点 击 鼠 标的 整个 过 程 中 , 其 他 所 有 应 用 程序 功能 是 不 会 被 阻塞 的 ; 在 
定时 需 工 作 时 ， 或 者 在 服务 天 等 待 一 个 Ajax 调用 返回 时 ， 服 务 器 上 的 其 他 功能 不 
会 被 阻塞 也 是 同样 的 道理 。 


在 本 章 中 , 我 们 会 更 加 深入 的 了 解 什么 是 异步 控制 。 特别 要 去 看 看 一 些 异步 设计 模 
式 ， 并 探索 一 些 Node 模块 。 使 用 这 些 模块 ， 我们 可 以 更 加 精细 地 控制 程序 流程 。 
另外 ， 我 们 还 会 看 看 在 使 用 异步 控制 后 ，Node 程序 如 何 捕获 并 处 理 异常 ， 以 及 进 
行 错误 处 理 时 使 用 的 一 些 新 的 有 趣 特性 。 


5.1 使 用 Callback 而 不 使 用 Promises 


在 早期 的 Node 版 本 中 , 使 用 promises 来 实现 异步 功能 。promises 是 一 个 出 现在 20 
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世纪 70 年 代 的 概念 ， 用 来 描述 异步 操作 的 结果 。 它 也 被 称 作 future, delay BATH 
单 的 deferred, CommonJS 的 设计 模型 就 实现 了 promise 的 概念 。 


在 早期 的 Node 实现 中 ，promise 对 象 仅仅 会 激发 两 个 事件 类 型 : success 和 error, E 
的 使 用 也 很 简单 : 如 果 一 个 异步 操作 成 功 ，success 事件 会 被 触发 ， 否 则 ，error 事件 
会 被 触发 。 除 此 之 外 ，promise 对 象 不 会 触发 其 他 事件 类 型 ， 而 且 它 只 能 触发 两 种 事 
件 中 的 一 个 ， 不 会 也 不 可 能 同时 触发 两 个 事件 。 另 外 ， 一 个 promise 对 象 总 共 只 能 触 
发 一 次 事件 ， 而 不 论 这 个 事件 是 success 还 是 error。 在 示例 5-1 的 代码 中 ， 我 们 在 一 
个 函数 中 使 用 了 旧版 本 的 promise 实现 ,这 个 函数 同时 还 会 打开 并 读 取 一 个 文件 内 容 。 


示例 5-1 使 用 Node promise 


function test_and_load(filename) { 
var promise = new process.Promise(); 
fs.stat(filename).addCallback(function (stat) { 


// Filter out non-files 
if (!stat.isFile()) { promise.emitSuccess(); return; } 


// Otherwise read the file in 

fs.readFile(filename).addCallback(function (data) { 
promise.emitSuccess(data) ; 

}).addErrback(function (error) { 
promise.emitError(error) ; 


° 
2 


}).addErrback(function (error) { 
promise.emitError (error); 


return promise; 


每 个 对 象 都 能 返回 promise 对 象 。 通 过 promise 对 象 的 addCallback 方法 可 以 绑 定 一 
个 回调 函数 来 做 异步 操作 成 功 后 的 处 理 ， 该 回调 函数 只 有 一 个 参数 data. iw 
promise 对 象 的 addErrback 方法 可 以 绑 定 一 个 回调 函数 来 处 理 异 步 操 作 失 败 的 情 
况 ， 该 回调 函数 也 同样 只 有 一 个 唯一 的 参数 error。 


var File = require('file'); 
var promise = File.read('mydata.txt'); 
promise.addCallback(function (data) { 
// process data 
}) ; 
promise.addErrback(function (err) { 
// deal with error 


}) 


在 对 异步 操作 得 到 的 执行 结果 或 者 错误 信息 处 理 完成 后 ，promise ASHE 
的 功能 被 调用 执行 。 
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提示 

示例 5-1 的 代码 是 参考 了 链接 http://groups.google.com/group/nodejs/browse_ 
thread/thread/8dab9f0a5ad753d5 中 提供 的 示例 ， 该 文档 中 还 包含 了 其 
他 一 些 示 例 ， 主 要 讨论 Node 中 使 用 的 一 些 异 步 技术 。 


promise 对 象 在 Node 0.1.30 版 本 中 被 移 除 。Ryan Dahl 当时 也 给 出 了 这 么 做 的 原因 : 


许多 人 (也 包括 我 自己 ) 往往 习惯 于 调用 底层 接口 来 操作 文件 系统 ， 而 不 是 每 次 都 
要 创建 一 个 对 象 ; 当然 , 也 有 很 多 人 会 比较 喜欢 类 似 于 promises 的 方式 。 因 此 , 我 
们 将 使 用 last callback functionality ( 即使 用 师 数 的 最 后 一 个 参数 作为 回调 ) 并 在 用 
户 库 中 建立 更 好 的 抽象 层 来 取代 promises. 


为 了 取代 promise 对 象 ，Node 使 用 了 last callback functionality ( 特 函 数 的 最 后 一 个 
参数 作为 回调 )。 正 如 我 们 在 之 前 章节 使 用 的 那样 ， 所 有 异步 方法 的 最 后 一 个 参数 
都 可 以 被 指派 一 个 回调 函数 , 而 这 个 回调 冰 数 的 第 一 个 参数 始终 是 一 个 error WH. 


为 了 说 明 该 回调 功能 的 基本 结构 ， 示 例 5-2 实现 了 一 个 完整 的 Node 应 用 程序 。 在 
程序 中 我 们 创建 了 一 个 对 象 ， 并 且 该 对 象 只 有 一 个 someMethod 方法 。 这 个 方法 有 
三 个 参数 ， 其 中 第 二 个 必须 是 一 个 字符 串 , 第 三 个 是 回调 因数 。 如 果 第 二 个 参数 丢 
失 或 不 是 一 个 字符 串 ， 一 个 Error 对 象 就 会 被 创建 并 传递 给 回调 也 数 。 否 则 ， 该 方 
法 会 传递 参数 给 回调 阴 数 。 


示例 5-2 last callback functionality 的 基本 结构 
var obj =function() { }; 





obj.prototype.doSomething = function(argi, arg2_) { 
var arg2 = typeof(arg2_) === ‘string’ ? arg2_: null; 


var callback_ = arguments[arguments.length - 1]; 
callback = (typeof(callback_) == ‘function’ ? callback_ : null); 


if (!arg2) 
return callback(new Error('second argument missing or not a string')); 


callback(arg1) ; 
var test = new obj(); 
try { 
test.doSomething('test', 3.55, function(err,value) { 
if (err) throw err; 


console. log(value) ; 


})3 
} catch(err) { 


console.error(err); 


last callback functionnality 结构 所 宕 的 关键 要 素 已 经 在 代码 中 以 粗 体 标注 。 


第 一 个 关键 点 是 确保 最 后 一 个 参数 是 一 个 回调 毅 数 。 我 们 不 能 确定 用 户 的 意图 , 但 
可 以 确保 最 后 一 个 参数 是 一 个 孔 数 而 且 也 不 得 不 这 样 做 。 第 二 个 关键 点 是 如 果 异 步 
操作 发 生 错 误 时 , 要 创建 新 的 Node Error 对 象 并 传递 给 回调 也 数 。 最 后 一 个 关键 点 
是 在 异步 操作 没有 发 生 任何 错误 时 ,调用 回调 也 数 并 传 入 处 理 结 果 。 总 之 ,其 他 都 
可 以 变 , 但 这 三 个 关键 点 必须 被 实现 : 


* 确 保 最 后 一 个 参数 是 一 个 函数 ; 

* 创 建 Node Error 对 象 ， 如 果 发 生 错 误 ， 则 传递 它 给 回调 也 数 ; 

* 如 果 没 有 发 生 错 误 ， 则 调用 回调 隐 数 ， 并 传递 处 理 结果 。 

运行 示例 5-1 的 代码 后 ， 应 用 程序 会 输出 以 下 错误 消息 到 控制 台 : 
[Error: second argument missing or not a string] 

修改 代码 中 的 方法 调用 : 
test .doSomething('test', 'this',function(err,value) { 


test Fy Hin HH FUE hl GE ERR: 


test.doSomething('test',function(err,value) { 
运行 后 会 再 次 得 到 一 个 错误 信息 ， 这 次 是 因为 缺少 第 二 个 参数 。 
如 


果 你 浏览 Node 安装 目录 中 lib 目录 下 的 所 有 代码 ， 你 会 发 现 last callback pattern 
在 很 多 地 方 反 复出 现 。 昌 然 功能 可 能 改变 ， 但 这 种 模式 保持 不 变 。 


虽然 这 是 一 种 相当 简单 的 方法 ,但 却 能 保证 不 同 异步 子 数 有 一 致 的 使 用 方法 。 然 而， 
这 种 方式 也 存在 一 些 问 题 ， 我 们 将 在 下 一 市 讨论 。 


5.2 顺序 调用 、 散 套 回调 、 异 常 捕获 


在 客户 端的 JavaScript 应 用 程序 中 ， 经 常会 看 到 以 下 代码 : 


vall = callFunctionA(); 
val2 = callFunctionB(vall); 
val3 = callFunctionC(val2); 
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明 数 被 依次 调用 执行 , 先 执 行 旺 数 的 输出 结果 会 作为 后 续 函 数 的 输入 参数 。 由 于 所 
A WI PRA La] A a] HAT, 我们 不 必 担 心 因为 孔 数 调用 顺序 发 生变 化 而 得 到 意料 
之 外 的 执行 结果 。 


示例 5-3 是 采用 了 常见 的 顺序 编程 方法 。 该 应 用 程序 使 用 Node 提供 的 非 异 步 版 本 
的 文件 系统 方法 , 在 打开 并 读 取 一 个 文件 后 , 对 其 内 容 进 行 了 修改 , 将 所 有 “apple” 
替换 为 “orange" ， 最 后 将 修改 后 的 数据 输出 到 一 个 新 文件 中 。 


示例 5-3 顺序 执行 的 示例 程序 


var fs = require('fs'); 


try { 
var data = fs.readFileSync('./apples.txt', ‘utf8'); 
console. log(data) ; 
var adjData = data.replace(/[A|a]pple/g, ‘orange’ ) ; 


fs.writeFileSync('./oranges.txt', adjData); 
} catch(err) { 
console.error(err); 


} 


由 于 不 能 确定 所 使 用 的 模块 是 否 能 够 捕获 并 处 理 错误 , 所 以 我 们 将 整 段 代码 放 在 一 
个 try 块 中 ， 以 便 程 序 在 产生 任何 可 能 的 错误 时 能 获得 更 多 的 异常 处 理 信息 。 下 面 
展示 了 当 应 用 程序 无 法 找到 要 读 取 的 文件 时 给 出 的 错误 信息 : 


{ [Error: ENOENT, no such file or directory './apples.txt'] 
errno: 34, 
code: 'ENOENT', 
path: './apples.txt', 
syscall: 'open' } 


虽然 这 段 错误 信息 看 起 来 并 不 是 特别 的 友好 ， 但 至 少 它 比 下 面 这 种 要 好 很 多 : 


node.js:201 
throw e; // process.nextTick error, or 'error' event on first tick 

Error: ENOENT, no such file or directory './apples.txt' 

at Object.openSync (fs.js:230:18) 

at Object.readFileSync (fs.js:120:15) 

at Object.<anonymous> (/home/examples/public_html/node/read.js:3:18) 

at Module. compile (module. js:441:26) 

at Object..js (module.js:459:10) 

at Module.load (module.js:348:31) 

at Function._load (module.js:308:12) 

at Array.0 (module.js:479:10) 

at EventEmitter. tickCallback (node.js:192:40) 


在 这 个 例子 中 ， RITI ARER, A BT PRR FEI A TAY o 
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要 将 这 个 同步 方式 的 程序 采用 异步 方式 实现 的 话 , 需要 做 一 些 修改 。 首 先 ， 必须 将 
所 有 因数 调用 更 换 为 异步 版 本 。 然 而 , 我 们 也 必须 考虑 到 的 一 个 事实 是 每 个 异步 所 
数 调用 都 是 不 阻塞 的 , 这 意味 着 这 些 男 数 是 相互 独立 的 , 这 样 我 们 就 无 法 保证 原本 
正确 的 逻辑 顺序 了。 唯一 能 保证 多 个 异步 了 水 数 能 按 正确 逻辑 顺序 被 调用 执行 的 方法 
是 使 用 舱 套 回调 (nested callbacks )。 


示例 5-4 是 修改 示例 5-3 后 得 到 的 异步 版 本 程序 。 所 有 的 文件 系统 相关 的 吨 数 调用 都 
采用 异步 版 本 取代 ,并且 使 用 了 藤 套 回调 以 保证 所 有 天 数 能 按照 正确 顺序 被 调用 执行 。 
示例 5-4 示例 5-3 程序 的 异步 实现 


var fs = require('fs'); 


try { 
fs.readFile('./apples2.txt','utf8', function(err,data) { 


if (err) throw err; 
var adjData = data.replace(/[A|a]pple/g, ‘orange’ ); 
fs.writeFile('./oranges.txt', adjData, function(err) { 


if (err) throw err 


3 


D; 
} catch(err) { 
console.error (err); 


在 示例 5-4 中 , 程序 首先 打开 指定 文件 , 然后 读 取 文件 内 容 ; 只 有 当 这 两 个 动作 完成 
后 ,作为 最 后 一 个 参数 的 回调 函数 才 会 被 调用 执行 。 回 调 函 数 首 先 检查 error 是 否 为 
空 ， 如 果 不 为 空 ， 则 抛 出 该 错误 对 象 。 最 外 层 的 异常 捕获 代码 会 处 理 该 错误 信息 。 


Aa 提示 
一 些 编程 规范 指导 并 不 建议 在 代码 中 抛 出 error， 或 采用 复杂 的 框架 来 保 
So 证 所 有 错误 都 能 被 捕获 并 处 理 。 但 无 论 如 何 ， 错 误 需 要 被 捕获 并 处 理 。 
如 果 没 有 错误 发 生 时 , 数据 会 先 经 过 替换 操作 处 理 , 然后 异步 版 本 的 writeFile 方法 
会 被 调用 。 这 个 异步 师 数 的 回调 男 数 只 有 一 个 参数 error。 如 果 error AA null, € 
将 被 抛 出 并 传递 给 外 层 的 异常 处 理 块 。 
如 果 发 生 错 误 ， 输 出 信息 看 起 来 会 类 似 于 以 下 内 容 : 


/home/examples/public html/node/read2.js:11 
if (err) throw err; 


A^ 


Error: ENOENT, no such file or directory './boogabooga/oranges.txt' 
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如 果 你 想 查看 调用 堆栈 来 跟踪 错误 ， 可 以 打印 出 error 对 象 stack 属性 : 


catch(err) { 
console.log(err.stack) ; 


} 


示例 5-5 的 代码 中 TTA TVR — A Be PCR AL, SC SARE A EAS 
目的 是 为 了 访问 一 个 目录 中 的 文件 清单 。 程 序 使 用 字符 串 类 提供 的 replace 方法 将 每 
个 文件 中 的 域名 替换 为 指定 域名 ， 并 把 结果 写 回 到 原文 件 中 。 同 时 ， 我们 还 打开 了 
一 个 可 写 流 来 保存 对 每 个 文件 的 修改 记录 。 


示例 5-5 读 取 目 录 文 件 列表 并 修改 文件 内 容 


var fs = require('fs'); 


var writeStream = fs.createWriteStream('./log.txt', 
{'flags' : 'a', 
'encoding' : ‘utf8', 
'mode' : 0666}); 


try { 
// get list of files 
fs.readdir('./data/', function(err, files) { 


// for each file 
files.forEach(function(name) { 


// modify contents 
fs.readFile('./data/' + name,'utf8', function(err,data) { 


if (err) throw err; 
var adjData = data.replace(/somecompany\.com/g, 'burningbird.net' ); 


// write to file 
fs.writeFile('./data/' + name, adjData, function(err) { 


if (err) throw err; 


// log write 
writeStream.write('changed ' + name + '\n', ‘utf8', function(err) { 


if(err) throw err; 


3 


H 
}); 


}); 
} catch(err) { 
console.error(util.inspect(err)); 


尽管 应 用 程序 看 起 来 像 是 单独 处 理 完 一 个 文件 然后 再 移动 并 处 理 下 一 个 文件 ， 但 它 
的 确 是 异步 工作 的 。 如 果 你 在 多 次 运行 应 用 程序 后 观察 log.txt 文件 的 内 容 , 会 发 现 
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程序 在 每 次 运行 时 处 理 文件 的 顺序 都 是 不 一 样 的 ， 而 且 看 起 来 更 像 是 随机 的 。 在 我 的 


data 子 目 录 中 有 五 个 文件 。 运 行 应 用 程序 三 次 后 ， 我 得 到 的 log.txt 文件 内 容 如 下 : 


.七 x 七 


changed datal 
changed data3. 
changed data5. 
changed data2. 
changed data4 


changed data3. 
changed datal 
changed data5. 
changed data2. 
changed data4 


changed datal 
changed data3. 
changed data5 
changed data4. 
changed data2. 


txt 
txt 
txt 


txt 


txt 


CXC 


CXT 
txt 


SCRC 


CXT 


txt 


.txt 


CXE 
txt 


这 里 有 一 个 问题 : 怎么 才能 知道 所 有 文件 都 被 处 理 完 成 的 时 间 点 呢 ? 也 许 我 们 想 知 
道 这 个 时 间 点 ,以便 做 一 些 后 续 处 理 操 作 。 不 过 ,代码 中 为 forEach 方法 指定 的 回调 
PRANAB SEAL A), 因此 不 会 阻塞 程序 。 让 我 们 先 在 forEach 语句 后 面 添 加 如 下 代码 : 


console.log('all done'); 


当 程序 输出 “all done” 时 ， 并 不 表示 所 有 处 理 都 完成 了 ， 它 仅 能 说 明 forEach 方法 


WARE, 


再 次 修改 程序 ， 在 输出 信息 到 log.txt 文件 的 地 方 增加 console.log 输出 ， 如 下 所 示 : 


writeStream.write('changed ' + name + '\n', ‘utf8', function(err) { 


if(err) throw err; 
console.log('finished ' + name); 


FIJ 


同时 在 forEach 方法 后 添加 如 下 代码 : 
console.log('all finished'); 


运行 程序 后 ， 你 会 得 到 如 下 控制 台 输 出 : 


all done 


finished data3. 
finished datal. 
finished data5. 
finished data2. 
finished data4. 


txt 
txt 
txt 
txt 
txt 
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为 了 解决 这 个 问题 ， 需 要 添加 一 个 计数 器 。 在 每 次 记录 日 志 信 息 的 时 候 让 这 个 计数 器 
递增 ， 然 后 将 计数 值 与 文件 数组 的 长 度 对 比 来 决定 是 否 打印 输出 “all done” JAE: 


// before accessing directory 
var counter = 0; 


writeStream.write('changed ' + name + '\n', ‘utf8', function (err) { 
if(err) throw err; 
console.log('finished ' + name); 
countert+t; 
if (counter >= files.length) 
console.log('all done'); 


}); 
再 次 运行 程序 , 你 会 得 到 预期 结果 :“all done” 消 息 在 所 有 的 文件 被 更 新 后 才 输 出 。 


在 程序 所 访问 的 目录 中 如 果 没 有 子 目 录 的 话 , 这 段 示 例 程 序 会 工作 得 很 好 。 如 果 存 
在 子 目录 的 话 ， 程 序 会 输出 以 下 错误 信息 : 


/home/examples/public_html/node/example5.js:20 
if (err) throw err; 


AN 


Error: EISDIR, illegal operation on a directory 


示例 5-6 使 用 fs.stats 方法 来 防止 发 生 这 种 错误 。fs.stats 方法 会 返回 一 个 对 象 , 用 于 描述 
Unix 中 stat 命令 所 返回 的 数据 。 这 个 对 象 包 含 的 信息 可 以 用 来 判断 当前 对 象 是 否 是 一 个 
文件 。 同 样 的 ，fs.stats 也 是 以 异步 方式 工作 的 ， 因 此 我 们 需要 做 更 深 的 回调 瞬 套 。 


示例 5-6 使 用 stats 函数 检查 文件 类 型 
var fs = require('fs'); 
var writeStream = fs.createWriteStream('./log.txt', 
{'flags' : 'a', 
‘encoding’ : ‘utf8', 
"mode' : 0666}); 


try { 
// get list of files 
fs.readdir('./data/', function(err, files) { 


// for each file 
files.forEach(function(name) { 


// check to see if object is file 
fs.stat('./data/' + name, function(err, stats) { 


if (err) throw err; 


if (stats.isFile()) 
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})3 


})5 


}); 
} catch(err) { 


// modify contents 
fs.readFile('./data/' + name,'utf8', function(err,data) { 


if (err) throw err; 
var adjData = data.replace(/somecompany\.com/g, 'burningbird.net'); 


// write to file 
fs.writeFile('./data/' + name, adjData, function(err) { 


if (err) throw err; 


// log write 
writeStream.write('changed ' + name + '\n', ‘utf8', 
function(err) { 
if(err) throw err; 
》 
}); 
}); 


console.error(err); 


这 样 应 用 程序 又 可 以 按照 预期 执行 了 , 并 且 执 行 得 很 好 , (Er TEH T LERE, 
对 代码 的 阅读 和 维护 就 显得 很 困难 了 。 我 曾经 听 说 人 们 把 这 种 回调 车 套 也 叫做 
callback spaghetti ， 还 有 一 个 更 形象 的 说 法 是 pyramid of doom， 这 两 个 叫 法 都 能 说 


明 这 个 问题 。 


KERRE, 代码 文档 的 边沿 就 更 向 右 扩 展 , 也 使 得 我 们 更 难以 保证 之 后 的 回调 
盟 数 中 代码 的 正确 性 。 然 而 ,我 们 不 能 打破 回调 散 套 ,因为 是 它 保证 了 函数 能 依次 
按照 如 下 顺序 被 调用 执行 : 


1. 首先 检索 目录 内 容 ; 
2 过滤 挥 子 目 录 ; 
3. 读 取 每 个 文件 的 内 容 ; 


4. 修改 内 容 ; 


5. 将 内 容 写 回 到 原文 件 。 


因此 ， 我 们 需要 做 的 是 找到 为 一 种 方法 来 完成 按 序 对 这 一 系列 方法 的 调用 ， 而 
不 必 依 赖 于 骸 套 回调 。 为 了 达到 这 样 的 目的 ， 就 需要 使 用 提供 异步 控制 流 的 第 


三 方 模块 。 
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提示 

为 所 有 异步 方法 使 用 同一 个 回调 函数 也 是 一 种 办 法 。 通 过 这 种 方式 ， 
你 可 以 使 得 代码 扁平 化 ， 也 可 以 简化 调试 。 然 而 ， 这 种 方法 还 存在 着 
其 他 一 些 问 题 ， 比 如 如 何 确 定 所 有 处 理 已 经 完成 的 时 间 点 等 。 为 了 解 
决 这 个 问题 ， 你 仍然 需要 使 用 第 三 方 库 。 


5.3 ”异步 模式 和 控制 流 模 块 


示例 5-6 实现 的 应 用 程序 实际 上 就 展示 了 一 种 异步 模式 ， 每 个 函数 被 依次 调用 ， 并 且 
前 一 个 隐 数 将 处 理 结 果 传 递 给 下 一 个 处 理 函数 ， 并 仅 在 有 错误 发 生 时 整个 处 理 链条 才 
坚 止 。 男 外 还 有 几 个 与 此 类 似 的 模式 ， 它 们 之 间 有 些许 差异 而 且 叫 法 也 不 尽 相 同 。 


在 Node P Async 模块 可 以 支持 最 广泛 的 异步 控制 流 模式 ,并 提供 了 如 下 模式 列表 : 





waterfall 


所 月 数 按照 顺序 被 依次 调用 执行 , 所 有 的 处 理 结果 以 数组 形式 传递 给 最 后 一 
个 回调 曲 数 (也 叫 着 series 或 者 sequence )。 


series 


MA PR ASHE HOT BRC DA LAY , 所 有 的 处 理 结果 随机 的 以 数组 形式 传递 给 
最 后 一 个 回调 毅 数 。 


parallel 


MA PR PBC IFAT BT , EANES BUG , Ab HE BE ak (ia 2A BG A Te ARCE 
其 他 一 些 对 parallel 模式 的 解释 中 ， 结 果 数 组 并 不 是 模式 的 一 部 分 )。 


whilst 


重复 调用 一 个 也 数 ， 除 非 菜 些 预 设 的 起 始 条 件 返 回 false 或 者 发 生 错 误 后 才 调 
用 最 后 一 个 回调 函数 。 


queue 


PRIRJET ADT, 但 是 同一 时 间 可 并 行 执行 的 函数 总 数 有 一 定 限 制 , 没有 
被 执行 的 也 数 会 被 队列 起 来 等 等 执行 。 


until 


重复 调用 一 个 也 数 ， 和 下 到 后 处 理 判 断 规则 返回 false 或 者 发 生 销 误 后 才 调 用 最 
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后 一 个 回调 明 数 。 
auto 

Fe Tha Vel PRIAL EA PRIS EU FF ALD EE — 7S PRPC Ab SZ BR o 
iterator 

REP PRA RS, IR ARE RBA TAY next TEACH AY BE) o 
apply 

AS ZB Bl ES eR, SG AE HH EE o 
nextTick 

TE Node 的 下 一 轮 事 件 循环 中 调用 回调 另 数 ,该 模式 基于 process.nextTick 实现 。 
在 Node.js 网 站 提供 的 模块 列表 中 ， 有 一 个 “控制 流量 /异步 ( Control Flow/Async 
Goodies )” 分类。 在 这 份 列表 中 我 们 可 以 找到 Async 模块 ， 并 使 用 它 来 实现 上 述 异 
步 控 制 模 式 。 虽 然 不 是 每 一 个 控制 流量 模块 都 能 提供 对 所 有 模式 的 支持 , 但 他 们 大 
都 提供 了 对 常用 模式 的 支持 ， 比 如 : series ( 也 叫 sequence 或 者 waterfall， 如 上 面 
列表 所 列 , 尽管 Async 将 waterfall 与 series 分 别 单独 列 出 ) 和 parallel。 此 外 ,一些 
模块 还 依照 早期 Node 版 本 实现 了 promises 的 概念 ， 还 有 一 些 模块 实现 了 fibers 的 
概念 ， 它 能 模拟 线程 。 
在 接 下 来 的 几 个 小 市 中 ,我 会 使 用 两 个 比较 流行 的 并 日 一 直 有 作者 维护 的 控制 流 模 
KR: Step 和 Async。 尺 管 这 两 个 模块 都 提供 了 一 些 必要 功能 ,但 每 个 模块 也 都 提供 
了 各 自 独特 的 异步 控制 流 管理 。 
5.3.1 Step 
Step 是 一 个 用 于 简化 串 行 和 并 行 控 制 流 的 实用 模块 。 通 过 下 面 这 条 npm 指令 可 以 
BRE : 

npm install step 
Step 模块 对 外 仅 峻 露出 一 个 对 象 。 要 使 用 该 对 象 做 串 行 顺序 调用 的 话 , 需要 将 你 的 
异步 师 数 分 别 包 疹 在 多 个 明 数 中 ， 然 后 将 该 晒 数 序列 当 作 参数 传递 给 该 对 象 。 示 


例 5-7 展示 了 如 何 使 用 Step 对 象 ， 程 序 首 先 读 取 文件 内 容 ， 然 后 修改 内 容 ， 最 后 
把 修改 后 的 内 容 写 回 原文 件 。 
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示例 5-7 使 用 Step 执行 串 行 异步 任务 
var fs = require('fs'), 
Step = require('step'); 
try { 


Step ( 
function readData() 
fs.readFile('./data/datai.txt', ‘utf8', this); 


function modify(err, text) { 
if (err) throw err; 
return text.replace(/somecompany\.com/g, ‘burningbird.net' ); 


3 
function writeData(err, text) { 
if (err) throw err; 
fs.writeFile('./data/data1.txt', text, this); 
} 


); 
} catch(err) { 
console.error(err); 


在 Step 的 调用 序列 中 , 第 一 个 少数 是 readData, 该 函数 读 取 并 将 文件 内 容 保存 到 一 
个 字符 串 对 象 , 然后 将 其 传递 给 第 二 个 也 数 。 第 二 个 隐 数 使 用 替换 方法 修改 该 字符 
串 ,将 修改 结果 传递 到 第 三 个 函数 。 第 三 个 区 数 负责 将 修改 后 的 字符 串 写 回 原文 件 。 
欲 了 解 更 多 信息 , 请 参阅 Step 在 GitHub 上 的 站 点 : https://github.com/ 


creationix/step . 





LEFT EEA PI ETN, EET PRLS DOW ZETT YE fs.readFile 
AVA. Am, FEV FAAS RAAT, this 上 下 文 对 象 被 作为 最 后 一 个 参数 传递 给 
了 该 函数 ， 而 非 我 们 通常 使 用 回调 隐 数 。 在 异步 函数 执行 完毕 后 ， 它 得 到 的 所 有 数 
据 或 者 任何 可 能 的 错误 信息 都 会 传递 给 Step 调用 序列 中 的 下 一 个 函数 modify。 

modify 并 没有 调用 另 一 个 异步 图 数 , 它 所 做 的 所 有 工作 仅仅 是 对 字符 串 中 的 某 些 子 
串 做 替换 。 它 并 不 需要 使 用 this 上 下 文 对 象 , 而 是 通过 return 语句 将 处 理 结果 返回 。 


最 后 一 个 晴 数 得 到 了 新 修改 后 的 字符 串 , 并 将 其 写 回 原 文件 中 。 不 过 因为 它 是 一 个 
SAE PRA, 我们 同样 将 this 对 象 作为 最 后 一 个 参数 传人 。 如 果 不 将 this 作为 该 异步 
函数 的 最 后 一 个 参数 ,那么 当 产 生 错 误 信 息 时 ,就 只 能 在 更 外 层 进行 捕获 和 处 理 了 。 
可 以 做 个 测试 ， 假 如 将 代码 做 如 下 修改 ， 指 定 一 个 不 存在 的 子 目录 : 


function writeFile(err, text) { 
if (err) throw err; 
fs.writeFile('./boogabooga/data/datal.txt'); 
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| 
这 样 我 们 将 永远 不 会 知道 写 人 操作 实际 上 是 失败 了 。 


即使 第 二 个 函数 没有 使 用 异步 方式 ， 但 在 Step 调用 序列 中 ， 除 第 一 个 函数 外 ， 其 
余 函 数 的 第 一 个 参数 都 应 该 是 eroro 


示例 5-7 实现 了 示例 5-6 中 的 部 分 功能 。 那 么 它 是 否 能 对 多 个 文件 做 修改 呢 ? 答案 
是 肯定 的 ， 它 可 以 做 到 。 不 过 还 需要 先 做 一 些 修 改 ， 丢 掉 一 些 有 缺陷 的 代码 。 


在 示例 5-8 中 ， 我 添加 了 用 于 获取 指定 子 目 录 文 件 列表 的 异步 陋 数 readir。 像 示例 5-6 中 
一 样 通过 forEach 命令 处 理 文件 列表 , 但 是 在 调用 readFile 也 数 时 传人 的 最 后 一 个 参数 并 
个 是 回调 函数 或 者 this 对 象 。 在 Step 模块 中 ， 调 用 group 对 象 表示 需要 保留 一 个 参数 用 
于 保存 一 组 处 理 结果 ; 在 readFile eR EXT group 对 象 的 调用 意味 着 所 有 回调 函数 被 依次 
调用 后 ， 所 有 处 理 绪 果 将 被 放置 到 一 个 数组 中 并 传递 给 调用 链 中 的 下 一 个 函数 。 


示例 5-8 使 用 Step 的 group() 将 异步 处 理 分 组 


var fs = require('fs'), 
Step = require('step'), 
files, 
_dir = './data/'; 


try { 


Step ( 
function readDir() { 
fs.readdir( dir, this); 


3 
function readFile(err, results) { 
if (err) throw err; 
files = results; 
var group = this.group(); 
results. forEach(function(name) { 
fs.readFile( dir + name, ‘utf8', group()); 
}); 
}, 
function writeAll(err, data) { 
if (err) throw err; 
for (var i = 0; i < files.length; i++) { 
var adjdata = data[i].replace(/somecompany\.com/g, ‘burningbird.net' ); 
fs.writeFile( dir + files[i], adjdata, "utf8 ,this ) ; 


} 


); 
} catch(err) { 
console. log(err); 


代码 会 将 readdir 读 取 到 的 文件 列表 保存 在 全 局 变量 files 中 。 在 最 后 一 个 晒 数 里 ， 
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我 们 在 一 个 循环 体 中 通过 files 变量 拿 到 所 有 文件 名 称 并 修改 相应 的 文件 内 容 。 文 
件 名 称 以 及 修改 后 的 文件 内 容 都 在 最 后 调用 异步 孙 数 writeFile 时 用 到 了 。 


如 采 需 要 修改 的 文件 是 固定 的 ， 那 么 就 可 以 进行 使 编码 并 使 用 Step 提供 的 另 一 种 
方法 parallel 来 实现 该 程序 。 在 示例 5-9 中 , 一 个 readFile 异步 多 数 被 调用 多 次 , 每 
次 打开 不 同 的 文件 ,并 指定 this.parallel(0 作 为 最 后 一 个 参数 .这 样 , 每 次 调用 readFile 
也 数 读 取 到 的 文件 内 容 会 作为 第 二 个 调用 链 也 数 的 一 个 参数 ,同样 在 第 二 个 也 数 中 
对 writeFile 的 调用 也 要 使 用 parallel0， 以 保证 每 个 回调 函数 被 依次 处 理 。 


示例 5-9 ”使 用 Step 模块 的 parallel 功能 对 一 组 文件 进行 读 写 操作 
var fs = require('fs'), 
Step = require('step'), 
files; 


try { 


Step ( 

function readFiles() { 
fs.readFile('./data/data1.txt', 'utf8',this.parallel()); 
fs.readFile('./data/data2.txt', ‘utf8',this.parallel()); 
fs.readFile('./data/data3.txt', ‘utf8',this.parallel()); 

function writeFiles(err, data1, data2, data3) { 
if (err) throw err; 
data1 = datai.replace(/somecompany\.com/g, 'burningbird.net' ); 
data2 = data2.replace(/somecompany\.com/g, 'burningbird.net' ); 
data3 = data3.replace(/somecompany\.com/g, 'burningbird.net' ); 


fs.writeFile('./data/data1.txt', data1, 'utf8', this.parallel()); 

fs.writeFile('./data/data2.txt', data2, 'utf8', this.parallel()); 

fs.writeFile('./data/data3.txt', data3, 'utf8', this.parallel()); 
} 


); 
} catch(err) { 

console. log(err); 
这 上 段 代 码 看 起 来 稍 显 笨拙 但 却 能 够 正常 工作 。 所 以 ， 当 你 需要 调用 一 序列 功能 各 不 
相同 但 又 可 以 并 行 执行 的 异步 水 数 , 并 且 之 后 的 处 理 分 析 又 需要 这 些 函 数 返 回 的 数 
据 时 ， 使 用 parallel 是 比较 合适 的 。 
不 过 当 Step 无 法 满足 需要 时 ， 我 们 无 需 在 代码 中 牵强 的 使 用 它 ， 因 为 还 有 另外 一 
个 库 : Async， 它 能 为 我 们 提供 更 好 的 灵活 性 。 
5.3.2 Async 
Async 模块 提供 了 对 集合 的 管理 功能 ， 例 如 each, map 和 filter。 此 外 ， 它 还 提供 了 一 些 
实用 功能 ， 例 如 memoization。 然 而 ， 此 刻 我 们 关心 的 是 它 对 流程 控制 的 支持 。 
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aH 
ER 
请 注意 Async 和 Async.js 模块 的 区 别 ， 不 要 将 两 者 混 消 。 本 章节 所 
讲 的 是 由 Caolan McMahon 编写 的 Async 模块 。 它 在 GitHub 的 地 址 


i= 


Æ: https://github.com/caolan/async. 


使 用 如 下 命令 安装 Async 模块 : 





npm install async 


我 们 之 前 对 Async 模块 做 过 介绍 ， 它 提供 的 流程 控制 功能 可 以 支持 多 种 异步 模式 ， 
包括 serial, parallel 和 waterfall。 与 Step 模块 一 样 ， 它 也 是 一 个 可 以 解决 艇 套 回 调 
问题 的 工具 , 但 其 实现 方式 却 完全 不 同 。 因 为 ， 无需 青 将 this 插入 每 个 也 数 的 实现 
中 来 替换 相应 的 回调 师 数 。 相 反 ， 它 是 通过 callback 来 融合 整个 执行 过 程 。 


我 们 已 经 知道 了 之 前 的 示例 程序 符合 Async 所 定义 的 waterfall 模式 ,因此 我 们 将 会 
使 用 async.waterfall 方法 。 在 示例 5-10 中 ， 我 使 用 async.waterfall 来 实现 一 序列 操 
VE, 包括 用 fs.readFile 打开 和 读 取 一 个 数据 文件 , 执行 一 个 同步 的 字符 串 蔡 换 操 作 ， 
然后 再 使 用 fs.writeFile 将 字符 串 写 回 到 文件 中 。 要 特别 留意 下 程序 每 一 步 操作 中 对 
callback PRAHA - 


示例 5-10 使 用 async.waterfall 异步 实现 读 取 ， 修 改 和 写 入 文件 内 容 


var fs = require('fs'), 
async = require('async'); 


try { 
async.waterfall([ 
function readData(callback) { 
fs.readFile('./data/datai.txt', ‘utf8', function(err, data){ 
callback(err, data); 
})3 
Jo 


function modify(text, callback) { 
var adjdata=text.replace(/somecompany\.com/g,'burningbird.net'); 
callback(null, adjdata); 
}， 
function writeData(text, callback) { 
fs.writeFile('./data/data1.txt', text, function(err) { 
callback(err,text); 


F); 


], function (err, result) { 
if (err) throw err; 
console. log(result) ; 

}); 

} catch(err) { 
console. log(err); 
} 
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async.waterfall 方法 有 两 个 参数 : 一 个 任务 数组 以 及 一 个 可 选 的 最 终 回调 函数 (final 
callback function )。 任务 数组 中 的 每 一 个 元 素 都 是 一 个 任务 函数 ,而且 每 个 任务 函数 都 
需要 使 用 一 个 callback 来 作为 其 最 后 一 个 参数 。 正 是 由 于 使 用 了 callback, 才能 够 将 异 
步调 用 的 返回 处 理 结果 链接 起 来 ， 而 无 需 再 将 男 数 符 套 起 来 。 你 可 以 在 代码 中 看 到 ， 
XT RET PRK callback 的 使 用 与 正常 使 用 攀 套 回调 时 一 样 ， 不 过 还 有 一 个 事实 那 就 是 我 
们 无 需 再 在 每 个 盟 数 中 判断 错误 信息 了 。callback 需要 一 个 error 对 象 作 为 第 一 个 参数 。 
如 果 我 们 传递 一 个 error 对 象 给 callback 也 数 ， 整 个 处 理 过 程 将 会 在 这 一 点 结束 ,而 最 
Zea] Pe] PRA ( waterfall 方法 的 第 二 个 参数 ) 会 被 调用 。 我 们 可 以 在 最 终 回调 函数 中 测 
试 是 否 有 错误 发 生 ， 并 抛 出 错误 到 外 层 的 异常 处 理 块 (或 以 其 他 方式 处 理 )。 


readData PARVEZ S fs.readFile 调用 , 它 首 先 会 检查 是 否 有 错误 发 生 , 如 果 发 生 错 误 ， 
它 会 抛 出 错误 并 结束 处 理 过 程 。 如 果 不 是 , 它 会 调用 callback 也 数 作为 其 最 后 一 步 操 
作 。 通 过 该 操作 告诉 Async 调用 下 一 个 果 数 并 传递 相关 数据 。 而 下 一 个 任务 图 数 并 
不 是 异步 的 , 在 它 完 成 处 理 后 会 通过 调用 callback 来 传递 修改 后 的 数据 以 及 值 为 null 
的 错误 对 象 。 最 后 一 个 因数 writeData 调用 了 异步 的 writeFile， 我 们 将 上 一 步 处 理 的 
结果 传 入 该 异步 也 数 ， 同 时 在 该 异步 函数 自己 的 回调 例 程 中 进行 错误 检查 。 


of a, 提示 
示例 5-10 的 代码 中 , 我 们 使 用 了 命名 函数 ,而 在 Async 文档 中 使 用 匿 


过 


a 名 函数 。 不 过 ， 人 命名 函数 可 以 简化 调试 和 错误 处 理 。 但 无 论 如 何 ， 使 
用 命名 函数 还 是 匿名 函数 ，Async 都 能 很 好 地 工作 。 


处 理 过 程 与 我 们 在 示例 5-4 做 的 非常 相似 , 但 没有 使 用 骨 套 ( 也 无 需 在 每 个 函数 中 
添加 错误 判断 ) 不 过 代码 看 起 来 比 示例 5-4 要 复杂 一 些 。 事 实 上 ， 我 的 确 不 推荐 
在 可 以 使 用 简单 时 套 调 用 的 情况 下 使 用 Async, 不 过 倒是 可 以 考虑 在 碰 到 复杂 让 套 
调用 时 使 用 它 。 示例 5-11 实现 了 示例 5-6 的 所 有 功能 , 但 没有 使 用 舱 套 回调 , 从 而 
避免 了 代码 的 过 度 缩 进 。 


示例 5-11 从 目录 中 获取 对 象 ， 测 试 并 寻找 文件 ; 读 取 文件 内 容 ， 修 改 并 写 回 ; 记录 
修改 日 志 


var fs = require('fs'), 
async = require('async'), 
_dir = './data/'; 


var writeStream = fs.createWriteStream('./log.txt', 
{'flags' : 'a', 
‘encoding’ : ‘utf8', 
‘mode’ : 0666}); 
try { 
async.waterfall([ 
function readDir(callback) { 
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fs.readdir( dir, function(err, files) { 
callback(err, files); 
t; 
}, 
function loopFiles(files, callback) { 
files. forEach(function (name) { 
callback (null, name); 
}); 
J 
function checkFile(file, callback) { 
fs.stat(_dir + file, function(err, stats) { 
callback(err, stats, file); 
Hs 


Jo 
function readData(stats, file, callback) { 

if (stats.isFile()) 

fs.readFile( dir + file, 'utf8', function(err, data){ 
callback(err,file,data); 
})3 

}, 
function modify(file, text, callback) { 

var adjdata=text.replace(/somecompany\.com/g, '‘burningbird.net' ); 

callback(null, file, adjdata); 


function writeData(file, text, callback) { 
fs.writeFile( dir + file, text, function(err) { 
callback(err, file); 


}); 
Jo 
function logChange(file, callback) { 
writeStream.write('changed ' + file + '\n', 'utf8', function(err) { 
callback(err, file); 


}); 


], function (err, result) { 
if (err) throw err; 
console.log('modified ' + result); 


Is 
} catch(err) { 
console. log(err); 

与 示例 5-6 实现 的 所 有 功能 一 样 。fs.readdir 方法 被 用 来 取得 目录 下 的 对 象 数组 。 
Node 提供 的 forEach Kii ( BCA (HFA Async 的 forEach ) 用 来 访问 每 一 个 文件 对 象 。 
fs.stats 方法 用 于 取得 每 个 对 象 的 stats 状态 信息 ， 以 便 检查 该 对 象 是 否 是 一 个 文件 ， 
如 果 是 文件 则 打开 并 访问 文件 数据 。 然 后 , 数据 被 修改 ,并 通过 fs.writeFile 将 数据 
写 回 文件 。 操 作 都 记录 在 日 志文 件 中 ， 同 时 也 会 输出 到 控制 合 。 


请 注意 ,我 们 可 能 需要 在 回调 明 数 间 传 递 大 量 数据 。 在 本 示例 代码 中 , H FIRS be 
数 都 使 用 到 了 filename 和 text， 所 以 它们 在 最 后 几 个 方法 间 传 递 。 我 们 可 以 在 方法 
间 传 递 任 何 数据 ， 只 要 第 一 个 参数 是 error 对 象 (如果 没有 错误 产生 ， 则 为 null )， 
并 保证 每 个 函数 的 最 后 一 个 参数 是 callback PAX. 
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我 们 不 必 在 每 个 异步 任务 陋 数 中 进行 错误 检查 ， 因 为 Async 会 在 每 个 callback 被 调用 
时 检查 error 对 象 ， 如 果 发 生 错 误 ， 则 停止 处 理 并 调用 最 终 回调 也 数 。 我 们 也 无 需 青 考 
虑 如 何 使 用 特别 的 方式 来 处 理 一 组 任务 『 ， 就 像 在 之 前 章节 使 用 Step 时 做 的 一 样 。 
Async 模块 还 文 持 其 他 一 些 流 程控 制 方法 ， 例 如 async.parallel 和 async.serial。 它 们 的 
使 用 方法 也 很 类 似 ， 首 先 需 要 一 个 任务 数组 作为 第 一 个 参数 ， 而 第 二 个 参数 是 可 选 的 
最 终 回 调 师 数 。 不 过 不 同 的 流程 控制 方法 对 异步 任务 的 处 理 还 是 有 稍 许 不 同 的 。 


rd a 提示 
| as 在 本 书 第 OE 9.2 节 , 我 们 会 使 用 async.searial 方法 构建 一 个 Redis 应 
te”, 
i 4. 用 程序 。 


async.parallel 方法 会 一 次 性 调用 所 有 异步 任务 ， 当 所 有 任务 执行 完毕 时 , 将 调用 最 
终 回 调 曙 数 。 示 例 5-12 使 用 async.parallel 并 行 读 取 三 个 文件 的 内 容 。 然 而 ， 该 程 
序 没 有 使 用 卫 数 数组 , 而 采用 了 Async 模块 提供 的 另 一 种 替代 方法 : 传人 一 个 包含 
有 上 所 有 异步 任务 的 对 象 , 每 个 任务 都 是 该 对 象 的 一 个 属性 。 当 三 个 任务 都 已 经 完成 
后 ， 结 果 会 输出 到 控制 台 。 


示例 5-12 使 用 并 行 方式 打开 三 个 文件 并 读 取 内 容 


var fs = require('fs'), 
async = require(‘async' ); 


try { 
async.parallel({ 
data1 : function (callback) { 
fs.readFile('./data/datai.txt', ‘utf8', function(err, data){ 
callback(err, data); 
}); 
Js 
data2 : function (callback) { 
fs.readFile('./data/data2.txt', 'utf8', function(err, data){ 
callback(err, data); 
})3 
小 
data3 : function readData3(callback) { 
fs.readFile('./data/data3.txt', 'utf8', function(err, data){ 
callback(err, data); 
})3 
}, 


}, function (err, result) { 
if (err) throw err; 


console. log(result); 


}); 
} catch(err) { 
console.log(err); 
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返回 的 结果 是 一 个 对 象 数组 , 每 个 对 象 的 属性 中 包含 相应 的 处 理 结果 。 如 果 在 本 例 
中 的 三 个 数据 文件 有 以 下 内 容 : 


e datal.txt: apples 
e data2.txt: oranges 
e  data3.txt: peaches 
运行 示例 5-12 的 结果 是 : 
{ datal: 'apples\n', data2: 'oranges\n', data3: 'peaches\n' } 


Async 模块 支持 的 其 他 控制 流 模式 就 留 给 读者 自己 练习 吧 ! 只 要 记 住 : 当 你 在 工作 
中 使 用 异步 控制 流 的 相关 方法 时 ， 需 要 传递 一 个 callback 给 每 个 异步 任务 ,并且 当 
任务 完成 后 需要 调用 这 个 callback 并 传人 一 个 错误 对 象 (或 null ) 以 及 任何 你 需要 
传递 的 数据 。 


5.4 Node 编码 风格 


本 书 中 我 很 多 次 提 到 并 给 出 了 一 些 编码 上 的 建议 ， 例 如 在 Node 中 使 用 命名 果 数 而 
非 匿名 曙 数 。 所 有 这 些 建议 可 以 被 理解 为 首选 风格 (preferred Node style )， 尽 管 并 
没 这 样 一 套 编程 风格 指南 或 一 套 共 享 风格 定义 。 事实 上 , 也 有 人 提出 过 一 些 不 同 的 
Node 风格 建议 。 


Va 提示 
Felix's node.js Style Guide 是 一 个 比较 好 的 Node.js 风格 指南 ， 可 以 在 
ò http://nodeguide.com/style.html 找到 。 


这 里 有 一 些 建议 ， 还 有 我 自己 对 这 些 建议 的 看 法 : 
SEE H ee PR CTE le AE PRB 

没 错 ， 这 对 Node 应 用 程序 至 关 重 要 。 

使 用 两 个 空格 的 缩 进 。 


我 的 看 法 : 对 不 起 , 我 习惯 使 用 三 个 空格 ,而且 我 也 将 继续 用 三 个 空格 。 我 认为 更 
重要 的 是 要 保持 一 致 并 且 不 要 使 用 tab， 而 非 对 空格 数 吹 毛 求 疯 。 


使 用 分 号 还 是 不 使 用 分 号 。 
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对 此 有 争议 的 确 令 人 人 惊讶。 我 使 用 分 号 ， 不 过 是 否 使 用 需要 看 你 自己 的 习惯 了 。 
使 用 单 引号 。 


REJEA G, BEERE ANI (或 多 或 少 )。 但 无 论 如 何 ， 在 定义 
有 单 引 号 内 容 的 字符 串 时 ， 最 好 能 使 用 双 引 号 将 字符 串 包 起 来 。 


当 定 义 多 个 变量 时 ， 是 否 只 使 用 一 个 var 关键 字 。 


在 这 本 书 的 应 用 程序 中 有 一 些 使 用 了 一 个 var KEF, 有些 则 没有 。 表 说 一 次 ， 老 
习惯 很 难 打破 ， 而 且 我 也 并 不 认为 这 个 问题 像 一 些 人 说 的 那么 严重 。 


常量 应 该 是 大 写 的 。 

我 同意 这 个 。 

变量 定义 应 该 采用 驼峰 式 大 小 写 (camel case )。 
我 或 多 或 少 同意 这 种 说 法 ,但 并 不 是 不 能 改变 。 
使 用 全 等 符 ( 一 = )。 


中 肯 的 意见 , 但 我 再 说 一 遍 ， 老 习惯 很 难 打破 。 我 建议 使 用 严格 相等 , 但 平常 情况 
下 仅 使 用 相等 〈 王 )。 不 要 像 我 一 样 有 这 个 坏 习 惯 。 


命名 你 的 闭 包 。 


我 再 次 没有 遵守 。 但 这 真 的 是 非常 中 肯 的 建议 , 我 想 改 掉 我 的 毛病 , 但 我 的 很 多 代 
RAME H T EA RR 


一 行 代码 的 最 大 长 度 应 小 于 80 个 字符 。 
同样 中 肯 的 意见 。 

大 括号 必须 在 同一 行 上 开始 。 
我 的 确 遵 守 了 这 条 建议 。 


除 过 这 些 建议 之 外 , 最 重要 是 要 记 住 : 随时 随地 的 使 用 异步 也 数 。 毕 竞 ， 异步 功能 
就 像 Node 的 心脏 。 
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第 6 章 


路 由 寻 址 、 服 务 文件 和 中 间 件 


当 你 在 网 页 上 点 击 一 个 链接 的 时 候 心 里 一 定期 望 着 什么 事情 发 生 , 一 般 都 期 竺 看 到 
一 个 新 加 载 的 页 面 。 但 是 , 在 网 络 资源 加 载 前 有 很 多 事情 发 生 ， 而 且 大 部 分 都 不 在 
我 们 的 控制 下 ( 比如 封包 路 由 )。 还 有 一 部 分 依赖 于 我 们 是 否 安 疫 了 一 些 软件 知道 
如 何 回应 点 击 的 该 链接 的 内 容 。 


当然 ， 我 们 在 使 用 类 似 于 Apache 的 服务 器 和 Drupal 这 类 软件 时 ， 大 部 分 对 文件 和 资源 
的 处 理 机 制 都 在 幕后 进行 了 。 然 而 ， 当 用 Node 创建 自己 的 服务 器 端 应 用 程序 而 没有 采 
用 常用 技术 的 时 候 , 我 们 必须 进一步 深入 研究 , 以 确保 正确 的 资源 在 正确 的 时 间 被 传递 。 


本 章 关 注 的 焦点 是 供 Node 开发 人 员 使 用 的 技术 ,提供 基本 的 路 由 以 及 中 间 件 功能 ， 
确保 资源 A 准确 快速 地 到 达 用 户 Bo 


6.1 从头 开始 : 创建 一 个 简单 的 静态 文件 服务 器 


我 们 现 有 的 功能 可 以 用 于 构建 一 个 简单 的 路 由 和 给 Node 内 置 一 个 提供 静态 文件 服 
务 。 但 是 “能 做 到 ”和 “容易 做 ”是 两 件 事情 。 


当 考虑 构建 一 个 简单 但 是 功能 完整 的 静态 文件 服务 器 时 ， 可 能 会 有 以 下 几 个 步 又: 
1. 创建 HTTP 服务 右 并 监听 是 否 有 请 求 ; 

2. 当 接 收 到 请 求 时 ,解析 请 求 的 URL， 决 定 文件 地 址 ; 

3. 检查 请 求 的 文件 是 否 存 在 ; 

4. 如 果 文 件 不 存在 ,给 出 适当 的 响应; 
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5， 如 果 文 件 存在 ， 打 开 文 件 进 行 读 取 ; 

6. 准备 响应 (respoonse ) 的 头 部 (header ); 
7， 将 文件 写 入 响应 内 容 ; 

8， 等 待 下 一 次 请 求 。 


创建 HTTP 服务 需 并 对 文件 进行 读 取 需 要 用 到 HTTP 和 FileSystem 模块 。 Path 模块 
也 派 得 上 用 场 , 它 可 以 在 读 取 文件 前 检查 确保 该 文件 存在 。 而 且 我 们 希望 为 根 目录 
定义 一 个 全 局 变量 ,或 者 也 可 以 使 用 预先 定义 好 的 ”dimame ( 更 多 关于 dirname 
内 容 请 见 接 下 来 的 说 明 栏 “为 什么 不 使 用 _dirname 呢 ?”，110 页 )。 


该 应 用 开头 部 分 如 下 代码 所 示 : 


var http = require('http'), 
path = require('path'), 
fs = require('fs'), 
base = 'home/examples/public html1'; 


借助 HTTP FESR GI EARS ARIF A ETT ZT ABE, AL A ee BY a 7 
HTTP 请 求 对 象 的 url 属性 得 到 请 求 的 文件 。 为 了 根据 请 求 确 认 response, RIJE 
console.log 中 输出 请 求 的 文件 路 径 名 。 当 服务 器 第 一 次 启动 时 ， 该 信息 会 显示 在 
console.log 的 输出 的 信息 中 。 


http.createServer(function (req, res) { 


pathname = base + req.url; 
console.log (pathname); 


}).listen(8124);}; 


console.log ('Server running at 8124/'); 


在 尝试 打开 文件 ， 读 取 文 件 内 容 并 写 和 人 HTTP response 中 之 前 ， 应 用 程序 需要 检查 
文件 是 否 存 在 。 此 时 ，path.exists 方法 是 个 很 好 的 选择 。 如 果 文 件 不 存在， 填写 一 
个 简单 的 信息 并 设置 状态 码 (status code) X 404: 找 不 到 该 文件 。 


path.exist (pathname, function (exists) { 
if (exits) { 
// 插 入 处 理 request 的 代码 
} else { 
res.writeHead (404); 
res.write('Bad request 404\n'); 
res.end(); 


} 


接 下 来 ， 我们 要 进入 这 个 新 应 用 程序 的 核心 了 。 在 前 面 章 市 的 例子 中 ， 我 们 使 用 
fs.readFile 读 取 文件 , fs.readFile 的 问题 在 于 读 取 的 内 容 必 须 每 到 整个 文件 全 部 读 取 
到 内 存 后 才 可 以 使 用 。 网 络 上 提供 的 文件 可 能 很 大 , 并 且 对 同一 个 文件 在 给 定 的 时 
间 可 能 有 很 多 请 求 ， 类 似 与 fs.readFile 这 样 的 功能 无 法 满足 需求 。 


ac A 

7 =A 

= path.exists 方法 在 Node 0.8 版 本 中 已 经 弃 用 了 ,新 的 替代 品 是 fs.exists. 
前 言 中 引用 的 示例 文件 包含 的 应 用 程序 对 两 种 方法 都 支持 。 


该 应 用 程序 通过 fs.createReadStream 方法 使 用 默认 设置 创建 文件 读 取 流 来 替代 
fs.readFile 方法 。 这 样 将 文件 内 容 用 pipe 方法 写 入 HTTP response 对 象 就 很 容易 了。 而 
日 流 对 象 在 内 容 传 输 结束 时 会 发 送 结束 信号 ， 所 以 我 们 并 不 需要 自己 调用 end 方法: 


res.setHeader('Content-Type', 'test/html'); 


//Status code:200 -- 找 到 文件 ， 无 错误 ; 
res.statusCode = 200; 


/ /创建 读 取 流 ， 传 输 内 容 
var file = fs.createReadStream(pathname) ; 
file.on("open", function() { 
file.pipe (res); 
}) ; 
file.on("error", function(err) { 
console.log (err); 


} ) ; 
流 读 取 (read stream) 有 两 个 事件 : open 和 error。 当 流 准备 好 的 时 候 触 发 open St 
件 ， 发 生 错 误 时 则 是 error 事件 。 该 程序 在 open 事件 的 回调 男 数 中 调用 pipe 方法 。 
在 这 一 点 上 ， 姜 态 文 件 服 务 需 的 应 用 如 示例 6-1 所 示 。 
示例 6-1 一 个 简单 的 静态 文件 网 络 服 务 器 


var http = require('http'), 


path require('path'), 
fs = require('fs'), 
base = '/home/examples/public_html'; 


http.createServer (function (req, res) { 


pathname = base + req.url; 
console.log (pathname); 


path.exists (pathname, function (exists) { 
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if ('exists) { 
res.writeHead (404); 
res.write('Bad request 404\n'); 
res.end(); 
} else { 
res.setHeader('Content-Type', 'text/html'); 


//Status code:200 -- 找 到 文件 ， 无 错误 ; 
res.statusCode = 200; 


/ /创建 读 取 流 ， 传 输 内 容 
var file = fs.createReadStream (pathname); 
file.on("open", function() { 
file.pipe(res); 
}); 
file.on("error", function(err) { 
console.log(err); 
} ) ; 
} 
} ) ; 
}) «Listen (8124) ; 


console.log('Server running at 8124/'); 


用 一 个 简单 的 HTML 文件 来 进行 测试 。 文 件 内 只 有 一 个 img 元 素 ， 检 测 文件 加 载 
以 及 显示 是 否 正 滑 : 


<!DOCTYPE html> 
<head> 

<title>Test</title> 

<meta charset="utf-8" /> 
</head> 
<body> 
<img src="./phoenix5a.png" /> 
</body> 


接 下 来 我 用 另 一 个 html 文件 测试 ， 该 文件 包含 HTMLS 的 video 元 素 : 


<!DOCTYPE html> 
<head> 
<title>Video</title> 
<meta charset="utf-8" /> 
</head> 
<body> 
<videoid="meadow" controls> 
<source src="videofile.mp4" /> 
<source src="videofile.ogv" /> 
<source src="videofile.webm" /> 
</video> 
</body> 
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在 Chrome 中 文件 可 以 打开 ， 视 频 正 党 播放。 但 是 在 Internet Exploer 10 中 ，video 
无 法 正常 显示 。 控 制 台 输 出 错误 信息 显示 了 失败 的 原因 . 
Server running at 8124/ 
/home/examples/public_html/html5media/chapterl/example2.html 
/home/examples/public_html/html5media/chapterl/videofile.mp4 


/home/examples/public_html/html5media/chapterl/videofile.ogv 
/home/examples/public_html/html5media/chapterl/videofile.webm 


尽管 正 10 支持 MP4 格式 的 视频 ， 但 是 对 上 述 例子 中 的 三 个 视频 文件 response 头 部 都 
是 text/html。 在 我 看 来 ， 其 他 的 浏览 右 忽 略 了 错误 的 头 部 类 型 信息 并 正确 显示 了 媒体 
uA, 但 下 没有 有。 这 是 我 的 猜测 ， 因 为 我 并 没有 很 快 发 现 应 用 程序 中 有 什么 错误 。 
提示 

表面 上 看 ， 照 理 服务 器 端 应 用 程序 可 以 只 使 用 一 种 浏览 器 进行 测试 ， 


但 是 为 什么 我 们 要 在 所 有 要 求 支持 的 浏览 器 上 对 应 用 程序 进行 测试 ， 
上 述 例 子 就 是 一 个 完美 的 解释 。 


我 们 需要 修改 应 用 程序 , 可 以 通过 检测 文件 扩展 名 在 response 头 部 文件 中 返回 适当 
的 MIME 类 型 。 我 们 可 以 自己 编码 写 该 功能 ， 但 是 我 更 推荐 使 用 一 个 现 有 的 模块 : 


node mime. 





提示 
可 以 用 npm 安装 node mime: npm install mime. GitHub 地 址 : 
https://github.com/broofa/node_mime. 





node mime 模块 可 以 根据 给 定 的 文件 名 〈 有 或 者 没有 路 径 都 可 以 ) 返回 对 应 的 
MIME 类 型 , 还 可 以 根据 给 定 的 类 型 返回 文件 扩展 名 。 将 node_mime 添加 到 require 
列表 中 : 


mime = require('mime'); 
返回 的 类 型 一 方面 会 用 于 response 头 文件 , 男 一 方面 也 会 在 控制 台 输 出 , 方便 我 们 
测试 应 用 程序 : 
// 类 型 


var type = mime.lookup (pathname); 
console.log (type); 
res.setHeader ('Content-Type', type); 


这 样 ， 在 IE10 中 的 video 元 素 加 载 该 文件 ， 视 频 就 能 正常 播放 了 o 
这 样 操 作 的 一 个 问题 在 于 当 我 们 访问 的 不 是 一 个 文件 而 是 一 个 日 录 的 时 候 , 控制 台 
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会 报错 ， 用 户 看 到 的 网 页 是 空 日 的 : 
{ [Error: EISDIR, illegal operation on a directory] errno: 28, code 'EISDIR" } 


这 样 , 我 们 不 仅 需 要 检查 访问 的 资源 文件 是 否 存 在 , 还 需要 检查 访问 的 路 径 是 文件 
还 是 一 个 目录 。 如 果 需 要 访问 的 是 一 个 目录 , 要 么 显示 目录 中 的 内 容 ， 或 者 直接 返 
回 鲁 误 信息 一 一 这 取决 于 开发 人 员 。 


一 个 小 的 静态 文件 服务 器 最 终 版 本 如 示例 6-2 所 示 , 使 用 ff.stats 检查 请 求 对 象 是 否 存在 ， 
是 否 为 文件 。 如果 资源 不 存在 , 返回 HTTP 状态 码 404。 如 果 资 源 存 在 但 是 为 一 个 目录 ， 
返回 的 HTTP 状态 码 403 一 一 禁止 访问 。 在 所 有 情况 下 ，request 都 有 相应 的 处 理 。 


示例 6-2 最 基本 的 静态 文件 服务 器 最 终 版 本 


var http = require('http'), 


url = regquire('url'), 

fs = require('fs'), 

mime = require('mime'); 

base = '/home/examples/public_html1'; 


http.createServer(function (req, res) { 


pathname = base + req.url; 
console.log (pathname); 


fs.stat (pathname, function (err, stats) { 
if (err) { 
res.writeHead (404); 
res.write('Bad request 404\n'); 
res.end(); 
} else if (stats.isFile()) { 
// 类 型 
var type = mime.lookup (pathname); 
console.log (type); 
res.setHeader ('Content-Type', type); 


// 200 status -找到 文件 ， 无 错误 


res.statusCode = 200; 


// 创建 文件 流 读 取 
var file = fs.createReadStream(pathname) ; 
file.on("open", function () { 


file.pipe (res); 

}) 7 

file.on("error", function (err) { 
console.log(err); 


belt 


} else { 


108 第 6 章 


res.writeHead (403); 


res.write('Directory access is forbidden'); 


res.end(); 


b); 
}) .listen (8124) ; 


console.log('Server running at 8124/'); 


以 下 是 访问 一 个 之 有 图 片 和 视频 页 面 时 控制 侣 的 输出 : 


/home/examples/public html/html5media/chapter2/examplel6.html 


text/html 


/home/examples/public html/html5media/chapter2/bigbuckposter.jpg 


image/jpeg 


/home/examples/public_html/html5media/chapter2/butterfly.png 


image/png 


/home/examples/public_html/favicon.ico 


image/x-icon 


/home/examples/public_html/html5media/chapter2/videofile.mp4 


video/mp4 


/nome/examples/public html/html5media/chapter2/videofile.mp4 


video/mp4 


这 样 就 处 理 好 了 不 同 的 类 型 。 图 6-1 显示 了 Chrome 下 显示 的 包含 视频 元 素 的 页 面 


以 及 控制 台中 显示 的 对 网 络 资源 的 访问 。 
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6-1 Chrome 加 载 示 例 6-2 中 静态 文件 服务 器 提供 的 网 页 时 ， 控 制 台 显示 内 容 
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现在 你 应 该 更 了 解 当 你 加 载 一 个 含有 视频 元 素 的 网 页 并 播放 视频 的 时 候 数据 流 是 
怎么 工作 的 。 浏 览 硕 以 一 个 可 控 的 速度 从 流 中 读 取 数据 ,填充 内 部 变量 ,然后 暂停 
答 出 。 如 果 在 视频 播放 的 时 候 关 闭 服务 需 ,， 视频 会 继续 播放 直到 当前 变量 中 的 内 容 
播放 完毕 。 之 后 无 法 从 流 中 获取 内 容 , 视频 元 素 就 变 成 空白 。 很 有 成 就 感 的 是 我 们 
付出 了 一 点 努力 就 可 以 看 到 各 个 组 件 是 怎么 一 起 工作 的 。 


为 什么 不 用 _dirname We? 


在 本 章 的 一 些 例子 中 ， 我 把 文件 的 路 径 例 如 /home/examples/public_html 硬 编码 在 代码 中 。 你 
可 能 很 好 奇 为 什么 不 直接 使 用 dirname. 


在 Node 中 可 以 使 用 预先 定好 的 ”dimame 作为 描述 当前 Node 应 用 工作 目录 的 变量 。 尽 管 上 
述 例子 中 访问 的 文件 独立 于 Node 程序 ,但 是 你 应 该 对 ”dimame LAR EE Node 开发 中 的 用 


处 有 一 定 了 解 。 dimame 提供 了 测试 程序 的 方法 ， 而 且 在 部 署 到 生产 环境 的 时 候 不 需要 修改 
文件 路 径 变 量 的 值 。 
按 如 下 方法 使 用 _ dirmame: 

var pathname = _ dirname + req.url; 


注意 dirname 前 缀 为 双 下 划 线 。 





尽管 通过 不 同类 型 文件 的 测试 表明 程序 工作 良好 , 但 是 它 并 不 完善 。 很 多 其 他 类 型 
的 网 络 请 求 都 没有 处 理 , 没有 安全 和 缓存 机 制 ， 也 并 没有 很 好 地 处 理 视 频 请 求 。 我 
测试 了 一 个 网 页 ， 使 用 HTML video 元 素 ， 并 使 用 HTMLS video 元 素 的 API 来 输 
出 视频 加 载 进 度 。 服 务 器 程序 没有 获取 到 需要 的 信息 ， 并 没有 像 预 期 一 样 工 作 。 


第 12 章 回顾 了 这 个 程序 ， 并 讨论 了 如 何 添加 其 他 的 部 分 来 完成 一 个 
a 功能 完善 的 HTMLS 视频 服务 器 。 


创建 一 个 静态 文件 服务 器 还 有 其 他 许多 细节 容易 犯错 , 这 需要 我 们 了 解 。 另 一 种 实 
现 方式 是 使 用 现 有 的 静态 文件 服务 器 。 在 下 一 节 中 ,我 们 会 学 习 一 种 由 Connect 中 
间 件 完成 的 方法 。 


6.2 ”中间 件 
什么 是 中 间 件 ? 好 问题 ， 但 是 不 幸 的 是 ， 对 这 一 问题 并 没有 明确 的 回答 。 
一 般 来 说 ， 中 间 件 是 一 个 软件 ， 存 在 于 开发 人 员 和 底层 系统 之 间 。 这 里 说 的 系统 ， 
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既 可 以 是 操作 系统 ， 也 可 以 是 底层 的 技术 文 持 ， 比 如 Node 提供 给 我 们 的 。 更 确切 
地 说 ， 中 间 件 将 目 己 插入 应 用 程序 和 底层 系统 的 通信 链 中 一 一 因此 而 得 名 中 间 件 。 


例如 ， 你 可 以 使 用 中 间 件 来 处 理 通过 网 络 服务 天 提 供 静 态 文件 服务 的 全 部 必需 功 
能 ， 而 无 需 目 己 处 理 。 中 间 件 可 以 处 理 宛 长 乏味 的 数据 流 , 这 样 你 就 可 以 关注 应 用 
程序 中 那些 满足 独一无二 需求 的 方面 。 但 是 , 中 间 件 能 做 的 远 远 不 止 静态 文件 的 服 
务 。 一 些 中 间 件 提供 验证 功能 、 代 理 、 路 由 、cookie 和 session 管理 ， 以 及 其 他 必 
要 的 网 络 技术 。 


中 间 件 并 不 是 一 个 可 用 的 函数 库 或 者 单纯 的 一 系列 困 数 集合 。 你 所 选择 的 中 间 件 决 
定 了 你 的 程序 如 何 设 计 及 开发 。 在 工作 开始 前 你 需要 慎重 选择 所 使 用 的 中 间 件 , 一 
旦 开发 工作 进行 ， 替换 中 间 件 是 件 非 常 痛 百 的 事情 。 


目前 Node 应 用 中 两 个 主流 中 间 件 应 用 程序 为 : JSGI ( JavaScript Gateway Interface, 
JavaScript 网 关 接 口 ) 和 Connect。JSGI 是 针对 于 一 般 JavaScript 的 中 间 件 技术 ,并 
不 特别 面向 Node. Node 中 可 以 使 用 JSGI-node 模块 。 而 Connect 则 是 设计 为 专门 
用 于 Node 开发 的 。 


a 提示 
JSGI 网 站 : http://wiki.commonjs.org/wiki/JSGI/Level0/A/Draft2. 
4" 


JSGI-node GitHub 地 址 : https://github.com/persvr/jsgi-node. 





本 书 中 只 介绍 Connect 主要 基于 以 下 三 个 原因 。 第 一 ，Connect 用 法 简单 。 相 较 而 
A, JSO 要 求 我 们 花费 更 多 的 是 理解 它 是 如 何 工 作 的 ( 独立 于 Node 的 用 法 )， 而 
Connect 则 可 以 立即 开始 。 第 二 ，Connect 提供 了 对 Express (一 个 非常 流行 的 架构 ， 
第 7 章 中 会 讲 到 ) 支持 。 第 三 ， 也 是 最 重要 的 一 点 ， 实 践 证 明了 Connect 是 最 好 的 
选择 。 从 npm registry 可 以 看 出 Connect 是 使 用 次 数 最 多 的 中 间 件 。 

提示 

关于 Connect 2.0 的 介绍 : http://tjholowaychuk.com/post/18418627138/ 


connect-2-0。 Connect 源 代码 : https://github.com/senchalabs/Connect. 
(更 多 关于 安装 事宜 ， 参 考 112 页 的 说 明 栏 。) 





6.2.1 Connect 基本 知识 
可 以 用 npm 安装 Connect: 
npm install connect 


事实 上 ，Connect 是 一 种 架构 ， 在 该 架构 中 你 可 以 使 用 一 种 或 多 种 的 中 间 件 。 关 于 
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Connect 的 文档 很 少 。 但 是 当 你 看 过 一 些 关 于 Connect 的 例子 之 后 会 发 现 使 用 
Connect 是 件 很 简单 的 事情 。 


使 用 Alpha 模块 


在 我 写本 章 初稿 的 时 候 ，npm registry 上 Connect 稳定 的 版 本 为 1.8.5, 但 是 我 想 讲 的 是 开发 版 
本 2.x， 因 为 这 很 可 能 是 你 会 使 用 的 版 本 。 


我 从 GitHub 上 下 载 了 Connect 2.x 的 源 代码 ， 放 在 我 开发 环境 中 node_modules 目录 下 。 然 后 
进入 Connect HR, H npm 安装 。 但 是 我 并 没有 给 出 具体 的 模块 名 称 ， 而 是 用 -d 参数 来 安装 
所 有 的 依赖 : 

npm install -d 
你 可 以 选择 用 npm 从 Git 软件 库 中 直接 安装 ， 或 者 克隆 整个 版 本 然后 按照 我 刚 描述 的 方法 进 
行 安装 。 
要 记得 一 点 ， 如 果 你 从 源 代码 直接 安装 模块 ， 当 运行 npm update 之 后 ，npm 会 用 自己 认为 是 
最 新 版 本 的 模块 覆盖 之 前 的 模块 一 一 即使 事实 上 被 覆盖 的 那个 模块 版 本 更 高 。 





在 示例 6-3 中 ， 我 使 用 了 Connect 以 及 Connect 自 带 的 两 个 中 间 件 'connect.logger 
和 connect.favicon 创建 了 一 个 简单 的 服务 器 程序 ,logger 记录 了 所 有 对 流 的 请 求 ( 在 
本 例 中 是 stdio.output 输出 流 ), favicon 中 间 件 则 提供 了 favicon.ico 文件 的 服务 。 该 
程序 包含 在 Connect 请 求 监听 右上 使 用 use 方法 的 中 间 件 。Connect 将 request 作为 
参数 传递 给 HTTP MAN createServer 方法 。 


示例 6-3 ”在 基于 Connect 的 程序 中 集成 logger 和 favicon 中 间 件 


var connect = require('connect'); 
var http = require('http'); 


var app = connect () 
.USe (connect. favicon () ) 
.USe (connect.logger () ) 
.use (function (req, res) { 
res.end('Hello World\n'); 
}); 
http.createServer (app) .listen(8124); 


你 可 以 使 用 任意 数量 的 中 间 件 , 不 管 是 Connect 内 建 的 或 者 第 三 方 提供 的 ， 只 需要 
使 用 use 语句 进行 添加 。 


' Connect 和 middleware 都 指 代 独 立 的 中 间 件 选项 。 在 本 章 遵循 这 一 管理 。 
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在 示例 6-4 中 ， 我 们 可 以 直接 在 createServer 方法 中 使 用 Connect 中 间 件 ， 而 不 必 
先 创建 Connect request listener. 


示例 6-4 直接 在 程序 中 加 入 Connect 内 建 的 中 间 件 


var connect = require('Connect'); 
var http = require('http'); 


http.createServer( connect () 
.Use (connect. favicon () ) 
-use(connect.logger () ) 
.use (function (req, res) { 
res.end('Hello World\n'); 
})) .-listen (8124); 


6.2.2 Connect 中间 件 
Connect 集成 了 至 少 20 个 中 间 件 , AEA PPRA Sr 28 , 但 是 需要 大 致 说 明 一 下 
便于 你 更 好 地 理解 它们 是 如 何 一 起 工作 的 。 

oe 提示 
如 何 使 用 Connect 中 间 件 的 其 他 例子 在 第 7 章 中 创建 的 Express 应 用 
> ARY. 





connect.static 


PREMARK, BE a RAS AFRA at. BE Connect 提供 了 中 
间 件 可 以 完成 该 服务 器 功能 ， 并 提供 更 多 其 他 功能 。 这 使 用 起 来 非常 简单 ， 只 需要 
设置 connect.static 中 间 件 选项 , 传递 给 所 有 请 求 的 根 目 录 。 下 面 这 段 代码 基本 实现 
了 示例 6-2 的 功能 ， 但 是 代码 更 简洁 : 

var connect = require('connect'), 


http = require('http'), 
_ dirname = '/home/examples'; 


http.createServer( connect () 
.USe (connect.logger() ) 
.use(connect.static(__dirname + 'public_html'), {redirect:true}) 
) -listen (8124) ; 


connect.static 将 根 目录 作为 第 一 个 参数 , 第 二 个 参数 可 选 。 第 二 个 参数 可 以 有 以 下 选项 : 
maxAge 


MARET, APA SM. MAN 0. 
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hidden 


设置 为 true 时 人 允许 传递 隐藏 文件 ， 默 认为 false。 


redirect 
设置 为 true 时 允许 重 定向 ， 路 径 名 为 目录 。 


这 个 简短 的 Connect 应 用 程序 显示 了 与 之 前 程序 在 行为 上 的 很 大 差异 。Connect 解 
决 方式 处 理 了 浏览 器 缓存 , 保护 程序 免 受 非法 URL Ate, 以 及 更 好 地 处 理 了 HTTP 
HTMLS 视频 元 素 ， 这 在 之 前 的 服务 需 程 序 中 并 没有 完成 。 与 之 前 的 服务 郁 程 序 相 
比 ， 这 种 解决 方式 的 唯一 缺点 在 于 对 错误 的 处 理 较 少 。 但 是 connect.static 确实 为 浏 
览 器 提供 了 不 同 的 response MIRDI. 


这 段 代码 以 及 本 节 之 前 的 例子 都 用 到 了 另 一 个 中 间 件 : connect.logger, 接 下 来 我 们 
就 要 介绍 这 个 中 间 件 。 
Connect.logger 


logger 中 间 件 模块 记录 对 流 的 请 求 ， 默 认输 出 到 stdout。 你 可 以 修改 输出 流 和 其 他 
一 些 选项 ， 包 括 缓 冲 时 间 、 样 式 ， 还 有 immediate 标识 ， 决 定 立 即 写 入 log 或 者 在 
响应 时 写 人 人 。 


除了 四 个 预先 定义 好 的 样式 ， 还 有 一 些 标识 用 于 定义 样式 : 


default 
' :remote-addr - - [:date] ":method :url HTTP/:http-version" :status :res[con 
tent-length] ":referrer" ":user-agent"' 
short 
':remote-addr - :method :url HTTP/:http-version :status :res[content- 
length] - :response-time ms' 
tiny 
":method :Url :status :res[content-length] - :response-time ms' 
dev 


开发 人 员 在 使 用 的 时 候 ， 根 据 response 状态 确定 输出 颜色 。 


默认 的 log 样式 如 下 所 示 : 
99.28.217.189 - - [Sat, 25 Feb 2012 02:18:22 GMT] "GET /examplel.html 
HTTP/1.1" 304 - "-" "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/535.11 


(KHTML, like Gecko) 

Chrome/17.0.963.56 Safari/535.11" 

99.28.217.189--[Sat, 25 Feb 2012 02:18:22 GMT] "GET /phoenix5a.png HTTP/1.1" 304 
- http://examples.burningbird.net:8124/examplel-.html 
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"Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/535.11 (KHTML, like Gecko) 
Chrome/17.0.963.56 Safari/535.11" 


99.28.217.189 - -~ [Sat, 25 Feb 2012 02:18:22 GMT] "GET /favicon.ico 
HTTP/ L-1” 
304 - "-" "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/535.11 (KHTML, 


like Gecko) 

Chrome/17.0.963.56 Safari/535.11" 

99.28.217.189 - - [Sat, 25 Feb 2012 02:18:28 GMT] 

"GET /html5media/chapter2/examplel6.html HTTP/1.1" 304 - "-" 


"Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/535.11 (KHTML, like Gecko) 
Chrome/17.0.963.56 Safari/535.11" 


这 种 输出 信息 量 很 大 ， 但 同时 宛 余 信息 太 多 ， 与 我 们 从 类 似 于 Apache 这 样 的 服务 
器 中 得 到 的 log 样式 类 似 。 你 可 以 修改 log 的 样式 或 者 将 输出 重 定 向 到 文件 中 。 
示例 6-5 使 用 connect.logger， 将 log 重 定 癌 到 文件 中 ， 并 设置 预定 义 的 dev 样式 。 


示例 6-5 将 log 写 入 文件 并 改变 样式 


var connect = require('connect'), 
http = require('http'), 
fs = require('fs'), 
_ dirname = '/home/examples'; 
var writeStream = fs.createWriteStream('./log.txt', 
{'flags':'a', 
'encoding':'utf8', 
'mode':0666}); 
http.createServer (connect () 
-use(connect.logger({format:'dev', stream:writeStream })) 
.use(connect.static(_ dirname + '/public_html')) 
). listen (8124); 


现在 的 log 输出 为 : 


GET /examplel.html 304 4ms 

GET /phoenix5a.png 304 lms 

GET /favicon.ico 304 lms 

GET /html5media/chapter2/examplel6é.html 304 2ms 
GET /html5media/chapter2/bigbuckposter.jpg 304 lms 
GET /html5media/chapter2/butterfly.png 304 lms 

GET /html5media/chapter2/examplel.html 304 lms 

GET /html5media/chapter2/bigbuckposter.png 304 Oms 
GET /html5media/chapter2/videofile.mp4 304 Oms 


虽然 信息 量 减少 了 ， 但 这 种 方式 更 便于 查看 请 求 状态 以 及 加 载 时 间 的 方式 。 


connect.parseCookie 和 connect.cookieSession 


之 前 我 们 自己 创建 的 文件 服务 器 并 没有 提供 对 HTTP cookies 和 session 状态 功能 的 
kifo FAKE, Connect 中 间 件 替 我 们 做 了 这 两 件 事 情 。 
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可 能 出 现 的 情况 的 是 ， 你 的 第 一 个 JavaScript 应 用 程序 用 于 创建 一 个 HTTP request 
cookie. connect.parseCookie 中 间 件 提供 了 功能 上 的 支持 ， 人 允许 我 们 访问 服务 器 上 的 
cookie 数据 。 它 解析 cookie 头 部 ， 用 cookie/data 得 到 req.cookies。 示 例 6-6 为 一 个 简 
单 的 网 络 服务 器 ， 根 据 username 从 cookie 中 提取 信息 ， 在 stdout 中 写 人 相关 信息 。 


示例 6-6 访问 HTTP request cookie， 用 于 console 信息 


var connect = require('connect') 
http = require('http'); 
var app = connect () 

.USe (connect.logger('dev') ) 

-use(connect.cookieParser() ) 

.use(function(req, res, next) { 
console.log('tracking ' + req.cookies.username) ; 
next (); 

} ) 


-use(connect.static('/home/examples/public html')); 


http.createServer (app) .listen(8124); 
console.log('Server listening on port 8124'); 


在 6.2.3 小 节 中 我 会 介绍 匿名 函数 的 用 法 ， 尤 其 是 next 函数 。 现 在 注意 力 集中 在 
connect.cookieParser 上 ， 可 以 看 到 这 个 中 间 件 解析 收 到 的 请 求 ， 从 header 中 读 取 
cookie 的 数据 并 存储 在 request 对 象 中 。 之 后 的 匿名 图 数 通过 cookies 对 象 访问 
username 数据 ， 输 出 到 控制 台 。 


为 了 创建 一 个 HTTP response cookie， 我 们 配合 connect.parseCookie 使 用 connect. 
cookieSession。connect.cookieSession 提供 安全 的 会 话 持 久 性 。 文 本 内 容 被 当做 字符 
串 传递 给 connect.cookieParser 函数 ， 为 session 数据 提供 安全 码 。session 数据 直接 添 
加 到 session 对 象 中 。 清 除 session 数据 的 时 候 ， 设置 该 session 对 象 为 null。 


示例 6-7 使 用 session cookie 来 跟踪 资源 访问 


var connect = require('connect') 
‚http = require('http'); 


// 清除 session 数据 
function clearSession(reg, res, next) I 
if ('"/clear' == req.url) { 
req.session = null; 
res.statusCode = 302; 
res.setHeader('Location', '/'); 
res.end(); 
} else { 
next (); 


// 跟踪 用 户 


function trackUser(req, res, next) { 
req.session.ct = req.session.ct || 0; 
req.session.username = req.session.username || regq.cookies.username; 
console.log(req.cookies.username + ' requested ' + 


req.session.ct++ + ' resources this session'); 
next () 


} 


// cookie # session 

var app = connect () 
.use(connect.logger ('dev') ) 
.use(connect.cookieParser('mumble') ) 
.use(connect.cookieSession({key:'tracking'}) ) 
.USe (clearSession) | 
.use(trackUser) ; 


// 静态 服务 器 
app.use(connect.static('/home/examples/public_html')); 
// 启动 服务 器 开始 监听 
http.createServer (app) .listen(8124); 
console.log('Server listening on port 8124'); 


图 6-2 显示 了 通过 示例 6-8 的 服务 器 应 用 访问 到 的 网 页 。 打 开 JavaScript 控制 台 可 以 看 到 
request 和 response 的 cookie。 注 意 到 response cookie 和 request 不 一 样 ， 是 经 过 加 密 的 。 


7 &? Test 





e © © examples.burningbird.net: Sl 24/exampie Liteni 


i: ¥ Request Cookies = 
i username : Shelley | 
taxing [M3BAM7TBR2ZcHWZZBWIAZ1IWZCWZ2u... | 
: | ¥ Response Cookies | 
: tracking |%3BA%7 B%2ZtRWZIRBAZZW2CH 22... 


| 1/3 requests | 3178/6498 trans $ 








6-2 Chrome 浏览 器 ，JavaScript 控制 人 台 ， 显 示 request cookie 和 response cookie 


用 户 访 问 的 文件 数目 可 以 持续 跟踪 ， 直 到 用 户 访 问 /clear URL (在 这 种 情况 下 
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session 对 象 被 设置 为 null ) RA KAMER, session 终止 。 


示例 6-7 中 也 使 用 了 其 他 一 些 自 定义 的 中 间 件 函数 。 在 下 一 个 关于 Connect WF 
( 也 是 最 后 一 节 ) 中 ， 我 们 会 讨论 这 些 函 数 如 何 与 Connect 交互 以 及 如 何 创 建 第 三 
方 的 中 间 件 。 


6.2.3 定制 Connect 中 间 件 

在 上 一 小 节 的 示例 6-7 中 , 我 们 创建 了 两 个 因数 作为 Connect 中 间 件 的 一 部 分 在 
request 到 达 最 终 服务 器 之 前 进行 处 理 。 传 递 给 该 孙 数 的 三 个 参数 为 HTTP 
request, HTTP response 和 回调 函数 next。 这 三 个 参数 构成 了 一 个 Connect 中 间 
件 函 数 的 签名 。 


为 了 更 深入 地 了 人 解 Connect 中 间 件 是 如 何 工作 的 , 我 们 来 看 看 一 个 在 之 前 代码 中 曾 
使 用 过 的 connect.favicon。 这 个 郴 数 的 功能 很 简单 ， 就 是 一 个 简单 的 呆 数 ， 提 供 默 
WAY favicon 或 者 提供 路 径 设 置 自 定义 的 favicon: 


connect () 
-use ( connect.favicon('someotherloc/favicon.ico') ) 


了 解 connect.favicon 工作 原理 的 原因 除了 它 的 用 处 之 外 , 主要 是 因为 它 是 最 简单 的 
中 间 件 ， 很 容易 还 原 工 程 。 


connect.favicon 的 源 代 码 ， 尤 其 是 与 其 他 源 代 码 对 比 之 后 会 发 现 : 所 有 导出 的 中 间 
件 都 返回 一 个 如 下 最 简 签 名 的 函数 : 


return function(reg, res, next) 


next 回调 函数 作为 函数 的 第 三 个 参数 ， 当 中 间 件 没有 处 理 当 前 请 求 或 者 处 理 中 断 
的 时 候 会 被 调用 。 如 果 中 间 件 处 理 过 程 中 出 现任 何 错误 ， 都 会 调用 next 回调 函数 ， 
并 将 error 对 象 返回 作为 参数 传递 给 next， 如 示例 6-8 所 示 。 


示例 6-8 favicon Connect 中 间 件 


module.exports = function favicon(path, options) { 
var options = options || {} 
, path = path || _dirname + '/../public/favicon.ico' 
, maxAge = options.maxAge || 86400000; 


return function favicon(req, res, next) { 
if ('/favicon.ico' == req.url) { 
if (icon) { 
res.writeHead(200, icon.headers); 
res.end(icon.body); 
} else { 
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fs.readFile(path, function (err, buf) { 
if (err) return next(err); 


icon = { 
headers: { 
'Content-Type': 'image/x-icon' 
, ‘Content-Length' :buf.length 
,'ETag':'"' + utils.md5 (buf) + '"'! 
, 'Cache-Control':'public, max-age=' + (maxAge / 1000) 
} ， 
body:buf 


}; 
res.writeHead(200, icon.headers) ; 
res.end(icon.body); 
}); 
} 
} else { 
next (); 


} 
}; 


next 回调 函数 调用 方法 就 是 链 式 函数 的 调用 方案 , 按照 序列 进行 。 在 收 到 的 request 
请 求 中 ,如 果 中 间 件 对 request 处 理 完 成 ， 比 如 请 求 favicon 的 request, 不 会 有 更 多 
的 中 间 件 被 调用 。 这 就 是 为 什么 在 你 的 应 用 程序 中 要 在 connect.logger 之 前 引入 
connect.favicon 为 了 防止 对 favicon.ico 的 请 求 造成 log 的 混乱 。 


http.createServer (connect () 
.use(connect.favicon('/public_html/favicon.ico') ) 
-use(connect.logger () ) 
.use(connect.static(_dirname + '/public_ html')) 
).listen (8124); 





你 已 经 学 会 了 如 何在 程序 之 中 创建 和 目 定 义 的 Connect 中 间 件 以 及 Connect 内 建 中 
间 件 应 该 是 什么 样子 的 ， 但 是 如 何 创建 一 个 第 三 方 的 中 间 件 而 不 是 直接 侍 入 在 程 
序 中 呢 ? 


创建 第 三 方 Connect 中 间 件 以 及 其 他 任何 你 需要 的 模块 ， 但 要 确保 它 包含 Conu 
所 需要 的 部 分 一 一 描述 三 个 参数 (req、res 、next )， 如 果 对 请 求 的 处 理 中 断 则 调用 
next 四 数 。 


示例 6-9 创建 了 一 个 Connect 中 间 件 ， 用 于 检查 请 求 的 文件 是 否 存在 以 及 判断 请 求 
内 容 是 否 是 个 文件 〈 而 不 是 目录 )。 如 果 请 求 内 容 为 一 个 目录 ， 则 返回 403 状态 码 
以 及 自 定义 的 错误 信息 。 如果 没有 上 述 情况 发 生 , 则 调用 next 触发 connect 中 间 件 ， 
来 唤醒 下 一 个 也 数 ( 本 例 中 为 connect.static )。 
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示例 6-9 创建 一 个 定制 的 错误 处 理 中 间 件 模块 


var fs = require('fs'); 


module.exports = function customHandler (path, missingmsg, directorymsg) { 
if (arguments. length < 3) throw new Error('missing parameter in customHandler') ; 
return function customHandler(req, res, next) { 
var pathname = path + req.url; 
console.log (pathname) ; 
fs.stat(pathname, function (err, stats) { 
if (err) { 
res.writeHead (404) ; 
res.write(missingmsg) ; 
res.end(); 
} else if (!stats.isFile()) { 
res.writeHead (403); 
res.write(directorymsg) ; 
res.end(); 
} else { 
next (); 


定制 的 Connect 中 间 件 在 错误 发 生 时 抛 出 错误 信息 , 如果 错 误 发 生 在 返回 函数 的 执 
行 过 程 中 ， 调 用 next 时 会 传人 error 对 象 : 


next(err); 


以 下 代码 告诉 我 们 如 何在 程序 中 使 用 目 定 义 的 中 间 件 : 


var connect = require('connect'), 
http = require('http'), 
fs = require('fs'), 
custom = require('./custom'), 
base = '/home/examples/public_html'; 


http.createServer (connect () 
-use(connect.favicon(base + '/favicon.ico')) 
-use(connect.logger () ) 
-use(custom(base + '/public_html', '404 File Not Found', 
"403 Directory Access Forbidden') ) 
.use(connect.static (base) ) 
).listen(8124) ; 


Connect 中 间 件 有 自己 的 errorHandler pi, (AE IFA REIAPIRIIN At, AW 
它 的 目的 是 提供 一 个 统一 格式 的 异常 信息 输出 。 在 第 7 章 中 你 可 以 看 到 该 方法 在 
Express 程序 中 的 使 用 。 
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还 有 其 他 一 些 与 Connect 绑 定 的 中 间 件 和 数量 巨大 的 兼容 Connect 的 第 三 方 中 间 
件 。 在 第 7 章 中 , 会 进一步 介绍 在 Express 应 用 架构 中 Connect 的 中 间 件 层 的 角色 。 
在 这 之 前 ， 我 们 先 来 看 两 个 其 他 类 型 的 服务 ， 这 两 个 服务 对 很 多 Node 应 用 都 是 必 


需 的 : routers 和 proxies. 


6.3 Routers 


路 由 是 指 从 一 个 源 接收 转发 到 男 一 个 地 方 。 一 般 来 说 , 转发 的 内 容 都 是 数据 包 , 但 
是 从 应 用 层面 来 看 ， 也 可 以 是 一 个 对 资源 的 请 求 。 


如 果 你 用 过 Drupal 或 者 WordPress, 你 已 经 见 过 了 路 由 是 如 何 工 作 的 。 如 果 没 有 任 
何 的 URL 重 定向， 用 户 访问 一 篇 文章 的 链接 应 该 是 : 


http://yourplace.org/node/174 
而 不 是 : 
http://yourplace.org/article/your-title 


http://yourplace.org/node/174 这 个 URL 是 路 由 工作 的 一 个 例子 。 本 例 中 URL 提供 
了 关于 网 络 程序 如 何 处 理 链接 的 信息 : 


e 访问 node 数据 库 (这 里 的 node Æ Drupal node ); 
。 ”查找 并 显示 id 为 174 的 node. 

另 一 个 例子 为 : 

http://yourplace.org/user/3 

同样 ， 访 问 用 户 数据 库 ， 碍 找 并 显示 id 为 3 的 用 户 。 


在 Node 中 ， 路 由 的 基本 作用 在 于 从 URI 中 获取 我 们 需要 的 信息 (通常 按照 某 种 
模式 获取 )， 用 这 些 信 息 触 发 正确 的 处 理 过 程 ， 并 将 这 些 信 息 传 递 给 该 处 理 过 程 。 


对 Node 开发 人 员 来 说 有 好 几 种 路 由 可 以 使 用 ， 包 括 Express 内 建 的 。 但 是 接 下 来 
我 要 介绍 的 是 一 种 更 通用 的 : Crossroads。 


提示 


Crossroads 官网 : http://millermedeiros.github.com/crossroads.js. 
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使 用 npm 安装 Crossroads: 


npm install crossroads 
该 模块 提供 了 大 量 以 及 文献 完整 的 API， 但 是 我 主要 关注 在 以 下 三 个 方法 : 
addRoute 
定义 一 个 新 模式 的 路 由 监听 。 
Parse 
解析 字符 串 ， 并 将 符合 的 字符 串 转 发 到 正确 的 路 由 。 
matched.add 
将 路 由 处 理 与 路 由 做 映射 。 


我 们 用 正则 表达 式 定 义 一 个 路 由 。 该 正则 表达 式 包 含 花 括号 ( {} )， 由 此 界定 传递 
给 路 由 处 理 函 数 的 命名 变量 。 比 如 ， 以 下 两 个 路 由 模式 : 


{type}/{id} 
node/ {id} 


都 可 以 匹配 : 
http://something.org/node/174 


两 者 的 差异 在 于 , type 在 第 一 个 模式 中 被 作为 参数 传递 给 处 理 函 数 ， 而 第 二 个 模式 
中 node 不 是 参数 。 


可 以 使 用 冒号 ( : ) 表示 可 选择 的 部 分 。 如 下 : 
category/:type:/:id: 

会 匹配 : 

category/ 

category/tech/ 

category/history/143 

将 request 传 给 parse 困 数 ， 触 发 路 由 处 理 的 过 程 : 


parse (request); 


122 第 6 章 


如 果 request 与 任 一 个 现 有 的 路 由 处 理 冰 数 匹配 ， 该 晒 数 将 被 调用 。 


示例 6-10 创建 了 一 个 简单 的 程序 用 于 查找 任意 给 定 的 分 类 以 及 出 版 物 。 程 序 按照 
request 中 的 要 求 将 结果 输出 到 控制 台 。 


示例 6-10 使 用 Crossroads 将 URL 请 求 定位 到 具体 的 操作 


var crossroads = require('crossroads'), 
http = require('http'); 


crossroads .addRoute ('/category/{type}/:pub:/:id:', function (type, pub, id) { 
if (lid && !pub) { 
console.log('Accessing all entries of category ' + type); 
return; 
} else if (!id) { 
console.log('Accessing all entries of category ' + type + 
"Ana pub. T + pup); 
return; 
} else { 
console.log ('Accessing item ' + id + ' of pub ' + pub + 
' of category ' + type); 


}); 


http.createServer(function (req, res) { 


crossroads.parse(req.url); 
res.end('and that\'s all\n'); 
}) . listen (8124); 


http://examples.burningbird.net:8124/category/history 
http://examples.burningbird.net:8124/category/history/journal 
http://examples.burningbird.net:8124/category/history/journal/174 


生成 的 信息 输出 为 : 
Accessing all entries of category history 


Accessing all entries of category history and pub journal 
Accessing item 174 of pub journal of category history 


为 了 匹配 类 似 Drupal 这 样 ， 对 象 具有 类 型 和 id 组合， 示例 6-11 使 用 了 Crossroads 
男 一 个 方法 : matchedadd， 来 将 路 由 处 理 映 射 到 一 个 具体 的 路 径 上 。 


示例 6-11 ”根据 给 定 的 路 径 映射 到 路 由 处 理 函数 


var crossroads = require('crossroads'), 
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http = require('http'); 
var typeRoute = crossroads.addRoute('/{type}/{id}"'); 


function onTypeAccess(type,id) { 
console.log('access ' + type + ' ' + id); 
}; 
typeRoute.matched.add(onTypeAccess) ; 
http.createServer (function(reqg,res) { 


crossroads.parse(req.url); 
res.end('processing'); 
}) .Listen(8124); 


该 段 程序 对 以 下 两 个 请 求 都 能 匹配 : 
/node/174 
/user/3 


Router 一 般 用 于 访问 数据 库 来 生成 返回 的 页 面 内 容 , 也 可 以 和 中 间 件 或 者 架构 模块 
一 起 使 用 来 处 理 收 到 的 请 求 , 尽管 这 些 程序 可 能 提供 了 自己 的 路 由 功能 。 在 下 一 节 


中 会 介绍 Crossroads 与 Connect 和 Proxy 的 配合 。 


6.4 Proxies 


代理 (Proxy ) 是 一 种 路 由 请 求 方式 ， 将 不 同 源 的 请 求 通过 同一 个 服务 器 处 理 ， 原 
因 可 能 有 很 多 : 缓存 、 安 全 ， 甚 至 是 故意 模糊 请 求 的 来 源 。 例 如 ， 公 开 访 问 代 理会 
被 用 于 解决 一 些 人 对 一 些 网 站 内 容 的 限制 访问 问题 , 它 会 使 从 一 些 请 求 的 发 起 方 看 
起 来 并 不 是 原来 的 来 源 。 这 类 型 的 代理 被 称 为 转发 代理 。 


还 有 一 种 被 称 为 反 回 代理 , 用 于 控制 请 求 如 何 被 发 送 到 服务 器 。 例 如 ， 现 在 有 五 个 
服务 器 , 但 是 有 四 个 不 希望 有 用 户 直 接 访 问 。 因 而 , 将 所 有 的 请 求 转发 到 第 五 个 服 
Fatt, 然后 再 代理 给 其 他 服务 右 。 反 向 代理 也 被 用 于 平衡 负载 和 通过 缓存 请 求 改进 
系统 的 整体 表现 。 


ae: 提示 
代理 的 另 一 个 用 法 是 将 一 个 局 部 的 服务 暴露 给 去 服务。 这 类 型 的 代理 


S 称 为 Reddish 代理 ， 该 代理 将 本 地 的 Redis 实例 暴露 给 新 的 Reddish 
服务 https:/reddi.sh/。 


在 Node 中 最 受 欢迎 的 代理 模块 为 http-proxy。 该 模块 提供 了 所 有 我 能 想到 以 及 想 不 
到 的 代理 功能 。http-proxy 提供 了 转发 以 及 反问 代理 功能 ， 可 以 用 于 WebSockets, 
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支持 HTTPS 以 及 处 理 延 时 。 有 名 的 nodejitsu.com 也 使 用 该 模块 ， 所 以 就 如 开发 者 
声明 的 一 样 ， 该 模块 久 经 考验 。 


提示 
http-proxy GitHub 网 页 : https://github.com/nodejitsu/node-http-proxy. 





用 npm 安装 http-proxy: 


npm install http-proxy 


http-proxy wA PLAY A ze BEF RS ae, FE Ea, AR 
BBS AIEA — Ain BY PO 2 RS A : 


var http = require('http'), 
httpProxy = require('http-proxy'); 


httpProxy.createServer (8124, 'localhost').listen (8000); 


http.createServer(function (req, res) { 
res.writeHead(200, { 'Content-Type': 'text/plain' }); 
res.write ('request successfully proxied!'+'\n' + JSON.stringify (req. headers, true, 
2) ) ; 
res.end(); 
}) .listen (8124); 


这 段 程序 所 做 的 全 部 功能 就 是 在 8000 端口 上 监听 请 求 ， 并 将 收 到 的 请 求 代理 到 
8124 端口 的 HTTP 服务 器 。 


我 的 系统 上 运行 这 段 程 序 输出 到 浏览 副 的 内 容 为 : 


request successfully proxied! 

{ 
"host": "examples.burningbird.net:8000", 
"connection": "keep-alive", 
"user-agent": "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/535.11 
(KHTML, like Gecko) Chrome/17.0.963.56 Safari/535.11", 
"accept": "text/html, application/xhtml+xml, application/xml;q=0.9,*/*;q=0.8", 
"accept-encoding":"gzip,deflate,sdch", 
"accept-language":"en-US,en;q=0.8", 
"accept-charset™:"ISO0O-8859-1, ut £-8; q=0.7, *;q=0.3", 
"cookie": "username=Shelley", 
"x-forwarded-for":"99.190.71.234", 
"x-forwarded-port": "54344", 
"x-forwarded-proto": "http" 
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本 例 中 使 用 代理 的 内 容 在 输出 中 用 黑体 标 出 。 注 意 到 一 点 , 之 前 的 例子 中 的 request 
cookie 依然 显示 出 来 了 。 


也 可 以 在 命令 行使 用 http-proxy。 在 bin 目录 中 有 一 个 命令 行程 序 、 接 收 端 口 、 目 
标 地 址 、 配 置 文件 、 配 置 代理 日 记 输 出 的 标志 位 作为 参数 , 还 可 以 使 用 -h 参数 显示 
帮助 内 容 。 监 听 8000 端口 并 将 请 求 转发 给 localhost 8124 端口 ， 代 码 如 下 : 


./node-http-proxy -—-port 8000 --target localhost:8124 
这 已 经 够 简单 了 。 如 果 你 希望 在 后 台 执 行 这 段 代 理 程 序 ， 在 末尾 加 上 符号 (& )。 


稍 后 我 会 在 本 书 中 介绍 http-proxy 与 WebSockets, HTTPS 配合 使 用 ,但 现在 ,我 
们 先 来 总 结 一 下 本 章 中 用 到 的 所 有 技术 一 一 静态 文件 服务 颖 、Connect 中 间 件 、 
Crossroads 路 由 ， 以 及 http-proxy 代理 。 来 创建 最 后 一 个 例子 ， 你 可 以 尝试 综合 
用 全 部 这 些 技术 。 


示例 6-12 中 会 使 用 http-proxy 测试 动态 收 到 的 请 求 ( 请 求 的 URL 都 以 node/ 开 始 )。 
如 果 找 到 匹配 ,路 由 会 将 该 请 求 转发 给 服务 器 ,服务 器 会 使 用 Crossroads 解析 相关 
的 数据 。 如 果 请 求 的 不 是 一 个 动态 资源 , 代理 会 将 请 求 转发 给 静态 文件 服务 器 ,该 
服务 器 会 用 到 Connect 中 间 件 ， 包 括 logger. favicon 和 static. 


示例 6-12 使 用 Connect, Crossroads 和 http—proxy 处 理 动态 和 静态 的 请 求 


var connect = require('connect'), 
http = require('http'), 
fs = reguire('fs'), 
crossroads = require('crossroads'), 
httpProxy = require('http-proxy'), 
base = '/home/examples/public_html'; 


/ /创建 代理 ， 监 听 请 求 


httpProxy.createServer (function(req,res,proxy) { 


if (req.url.match(/*\/node\//) ) 
proxy.proxyRequest (req, res, { 
host: ‘localhost’, 
port: 8000 


proxy.proxyRequest (req,res, { 
host: ‘localhost', 
port: 8124 
FE? 
}).listen (9000); 
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// 对 动态 资源 的 请 求 添加 路 由 
crossroads.addRoute('/node/{id}/', function(id) { 
console.log('accessed node ' + id); 


})3 


// 动 态 文件 服务 器 

http.createServer(function (req, res) { 
crossroads.parse(req.url); 
res.end('that\'s all!'); 

}) . listen (8000); 


11 SKA RH E 
http.createServer (connect () 
.USe (connect. favicon () ) 
.use(connect.logger ('dev') ) 
.use(connect.static (base) ) 
).listen (8124); 


用 以 下 URL ta WRIA ARS A : 


/node/345 

/examplel.html 

/node/800 
/htmlSmedia/chapter2/examplel4.html 


Pe ll Ha GAR, Se Ba a a CE AY AN TAS : 


accessed node 345 

GET /examplel.html 304 3ms 

GET /phoenix5a.png 304 lms 

accessed node 800 

GET /html5media/chapter2/examplel4.html 304 lms 
GET /html5media/chapter2/bigbuckposter.jpg 304 lms 


不 能 说 我 们 已 经 完成 了 一 半 的 CMS (内 容 管理 系统 ) 系统 ， 但 是 如 果 我 们 希望 构 
建 一 个 CMS 系统 的 话 已 经 拥有 了 需要 的 工具 。 但 是 既然 可 以 使 用 Node 支持 的 加 
构 ( 下 一 章 会 讲 到 ) 我 们 为 什么 还 要 自己 构建 呢 ? 


路 由 寻 址 、 服 务 文件 和 中 间 件 127 


第 7 章 


Express 框架 





框架 软件 能 够 提供 基础 设施 支持 , 使 我 们 能 够 更 迅速 地 创建 网 站 和 应 用 程序 。 框 染 
通常 还 提供 了 一 个 构建 骨架 , 实现 了 许多 在 开发 中 篆 见 但 又 必须 实现 的 代码 , 因而 
我 们 可 以 更 专注 于 创建 我 们 的 应 用 程序 或 站 点 所 真正 需要 的 功能 。 它 还 能 让 我 们 的 
代码 更 加 紧凑 ， 以 使 代码 更 易于 管理 和 维护 。 


我 们 已 经 交替 使 用 过 框架 和 库 的 概念 ,因为 在 各 种 应 用 程序 的 开发 过 程 中 , 两 者 都 
为 开发 者 提供 了 可 重用 的 功能 。 两 者 也 都 能 降低 代码 的 耦合 度 ， 但 它们 也 有 不 同 ， 
因为 框架 通常 还 提供 了 一 个 基础 设施 ， 可 以 影响 应 用 程序 的 整体 设计 。 


Node.js 中 有 一 些 非 常 完善 的 框架 ， 包括 Connect (在 第 6 章 介 绍 过 )， 尺 管 在 我 看 
来 Connect 更 像 是 一 个 中 间 件 而 非 框 架 。 如 果 综 合 考虑 框架 的 支持 、 功 能 完善 度 以 
及 流行 度 的 话 ， 有 两 个 Node 框架 是 比较 出 色 的 : Express 和 Geddy。 如 果 你 在 网 上 
搜索 两 者 之 间 的 差异 ， 人 们 可 能 会 说 Express 更 像 Sinatra 一 些 ， 而 Geddy 更 像 是 
Rails。 这 意味 如 果 用 非 Ruby 术语 来 说 ，Geddy 基于 MVC ( Model-View-Controller ), 

而 Express 则 更 多 使 用 REST 风格 《后 面 的 章节 对 此 有 更 详细 的 说 明 )。 


此 外 还 有 一 个 新 来 的 小 子 一 一 Flatiron， 以 前 它 作 为 一 些 独立 组 件 存在 ， 但 现在 已 
经 被 整合 在 一 起 而 形成 一 个 产品 。 为 一 个 在 node 工具 网 站 上 流行 的 框架 是 
Emberjs， 原 名 SproutCore 2.0。 它 是 除了 CoreJS 以 外 的 男 一 个 基于 MVC 的 框架 。 


我 曾 试 图 在 一 个 章节 中 对 上 述 每 个 框架 都 做 下 介绍 ， 但 事实 上 能 够 在 单独 一 个 章节 
介绍 清楚 一 个 框架 都 是 很 困难 的 ， 更 不 用 说 几 个 了 。 因 此 , 我 决定 在 本 章 着 重 介 绍 
Express 框架 。 虽 然 其 他 框架 也 都 非常 出 色 ， 但 我 喜欢 Express 的 开放 性 和 扩展 性 ， 
并 且 它 也 是 目前 最 流行 的 框 染 。 
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提示 
Geddy.js 的 网 站 地 址 是 http://geddyjs.org/. Flatiron 可 以 在 
è http://flatironjs.org/4% 2, Emberjs 在 Github 上 的 页 面 地 址 是 
https://github.com/emberjs/emberjs, îm CoreJS 的 主 站 是 http://echo. 


nextapp.com/site/corejs。Express 的 GitHub 页 面 在 https://github.com/ 
visionmedia/express。 Express 的 文档 放 在 http://expressjs。 


7.1 Express: 启动 和 运行 
安装 Express 很 容易 ， 使 用 以 下 npm 命令 即 可 : 


npm install express 


为 了 快速 上 手 Express, 最 好 通过 命令 行 工 具 来 生成 一 个 Express 应 用 程序 。 既然 目 
前 我 们 还 不 知道 想 在 程序 中 实现 些 什 么 东西 , 那么 干脆 就 在 一 个 干净 的 目录 中 创建 
并 运行 程序 ， 而 不 要 在 一 个 保存 了 各 种 有 用 资料 的 目录 中 创建 程序 。 


我 给 这 个 新 应 用 程序 起 了 一 个 足够 简单 的 名 字 site: 


express site 


该 命令 会 生成 几 个 目录 : 

create : site 
create : site/package.json 
create : site/app.js 
create : site/public 
create : site/public/javascripts 
create : site/public/images 
create : site/routes 
create : site/routes/index.js 
create : site/public/stylesheets 
create : site/public/stylesheets/style.css 
create : site/views 
create : site/views/layout.jade 
create : site/views/index.jade 


同时 你 还 会 看 到 一 条 有 用 的 提示 信息 ， 它 要 求 你 进入 到 site 目录 并 运行 npm 命令 : 


npm install -d 


一 旦 执行 该 命令 安装 应 用 程序 后 ， 就 可 以 使 用 node iz 


node app.js 


运行 app.js 文件 了 : 
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它 会 在 端口 3000 局 动 一 个 服务 端 应 用 程序 。 如 果 访 问 该 应 用 程序 ， 则 会 显示 一 个 


Express 
Welcome to Express 


至 此 ， 你 已 经 创建 了 第 一 个 Express 应 用 程序 。 现 在 ， 让 我 们 来 看 看 是 否 还 能 用 它 


来 做 更 多 有 趣 的 事情 。 


7.2 app.js 文件 


示例 7-1 显示 了 我 们 刚 运 行 过 的 app.js 文件 的 源 代 码 。 


示例 7-1 app.js 文件 的 源 代码 
/* 


* Module dependencies. 
7 


var express = require('express') 
, routes = require('./routes' ) 
, http = require('http'); 


var app = express(); 


app.configure(function(){ 
app.set('views', dirname + '/views' ); 
app.set('view engine’, 'jade'); 
app.use(express. favicon()); 
app.use(express. logger('dev')); 
app.use(express.static(_ dirname + '/public')); 
app.use(express.bodyParser()); 
app.use(express.methodOverride()); 
app.use(app.router) ; 


}); 


app.configure('development', function(){ 
app.use(express.errorHandler()); 


app-get('/', routes.index); 
http.createServer(app).listen(3000); 


console.log("Express server listening on port 3000"); 


从 代码 的 开始 部 位 可 以 看 出 程序 包含 了 三 个 模块 





Express, Node 的 HTTP 以 及 


一 个 刚刚 生成 的 模块 routes。 在 routes 子 目 录 中 ，index.js 文件 包含 如 下 代码 : 


/* 
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* GET home page. 


27 
exports.index = function(req, res){ 
res.render('index', { title: 'Express' }); 


bi 
从 代码 中 可 以 轻易 看 出 ， 我 们 使 用 了 Express 中 response 对 象 的 render WER HE 


指定 视图 ， 调 用 该 方法 时 ， 还 可 以 指定 一 组 选项 用 于 泻 染 ， 此 处 我 们 指定 了 title 
值 为 “Express”。 我 将 在 7.5 市 对 此 进行 介绍 。 


现在 ， 让 我 们 再 回 到 app.js。 在 包含 了 所 有 需要 的 模块 后 ， 它 又 创建 了 一 个 Express 对 
象 实例 ， 然 后 通过 调用 configure 方法 并 传递 一 组 可 选 参 数 来 配置 它 (在 下 面 “ 设 置 应 
用 程序 模式 ”说 明 栏 中 对 configure 有 更 多 介绍 )。configure 方法 的 第 一 参数 可 以 是 一 
个 可 选 参 数 ， 它 用 于 指明 当前 的 配置 项 是 否 针对 特定 环境 ( 例如 development 或 
production )。 当 没有 通过 该 参数 指定 环境 类 型 时 ， 配 置 项 会 被 应 用 到 所 有 环境 。appjjs 
中 对 configure 的 第 二 次 调用 指定 了 development 环境 。 如 果 愿 意 的 话 ， 你 可 以 为 每 一 个 
可 能 的 环境 类 型 分 别 调用 configure 方法 。 与 当前 环境 类 型 匹配 的 配置 项 将 会 被 处 理 。 


设置 应 用 程序 模式 


在 Express 应 用 程序 中 ， 我 们 可 以 使 用 configure 方法 来 为 应 用 程序 支持 的 任何 模式 指定 其 所 使 用 
的 中 间 件 、 配 置 项 以 及 可 选项 。 在 下 面 的 例子 中 ,该 方法 会 将 指定 的 配置 项 应 用 到 所 有 模式 : 


app.config(function() { ... } 


而 下 面 对 configure 方法 的 调用 则 保证 了 配置 项 仅 被 应 用 到 developmen 模式 : 


app.config('development', function() { ... } 


你 可 以 通过 环境 变量 NODE ENV 来 为 程序 指定 模式 : 


$ export NODE ENV=production 


$ export NODE ENV=ourproduction 


你 可 以 使 用 你 想 要 的 任何 名 称 。 默 认 情 况 下 ， 该 环境 变量 值 为 development。 


为 了 确保 应 用 程序 始终 运行 在 指定 模式 下 ， 可 以 在 用 户 配 置 文件 中 添加 并 导出 NODE_ENV 
环境 变量 。 





‘Configure 方法 的 第 二 个 参数 是 一 个 匿名 函数 ， 包 含 了 对 几 个 中 间 件 的 引用 。 这 与 
我 们 在 第 6 章 中 使 用 Connect 中 间 件 的 方式 类 似 。 其 实 ， 这 并 不 是 偶然 现象 ， 因 为 
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Connect 和 Express 的 主要 作者 是 同一 个 人 : TJ Holowaychuk。 不 一 样 的 是 这 里 对 
app.set 方法 的 调用 发 生 了 两 次 。 


app.set 方法 用 于 设置 各 种 配置 项 变量 ， 例 如 程序 视图 的 存储 位 置 : 


app.set('views', dirname + '/views'); 


以 及 使 用 的 视图 引 警 ( 这 里 使 用 Jade): 


app.set('view engine', 'jade'); 


在 app.js 文件 中 ， 还 使 用 了 favicon, logger 和 static 等 中 间 件 ， 这 些 就 无 需 进一步 
解释 了 : 


app.use(express.favicon()); 
app.use(express.logger('dev')); 
app.use(express.static( dirname + '/public')); 


其 实 ， 我 们 还 可 以 在 创建 服务 器 的 时 候 调 用 Express 中 间 件 : 


var app = express.createServer ( 
express.logger(), 
express.bodyParts () 

) 7 


不 管 使 用 哪 种 方法 都 是 可 以 的 。 
接 下 来 ， 在 生成 的 代码 中 ， 我 们 还 会 看 到 程序 使 用 了 下 面 三 个 中 间 件 /框架 组 件 : 


app.use (express .bodyParser () ) ; 
app.use(express.methodOverride()); 
app.use(app.router); 


bodyParser 中 间 件 与 其 他 中 间 件 一 样 也 直接 来 目 Connect. Express 所 做 的 仅仅 是 重用 它 。 


我 在 前 面 的 章节 中 介绍 了 logger, favicon 以 及 static, 但 是 没有 介绍 bodyParse。 这 
个 中 间 件 会 解析 传人 的 请 求 内 容 ,， 将 其 转换 为 一 个 request 对 象 的 属性 。Express 的 
methodOverride 也 是 来 自 Connect, 它 能 通过 表单 中 的 一 个 隐藏 域 _ method 来 实现 对 
Full REST 的 支持 。 

\ 提示 

支持 Full REST (表述 性 状态 传输 ) 意味 着 不 但 要 支持 HTTP GET 和 
POST 操作 , 还 要 支持 HTTP 的 PUT # DELETE 操作 . 我 们 会 在 7.5.2 
小 节 对 此 进行 讨论 。 
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最 后 的 配置 项 是 app.router。 这 个 中 间 件 是 可 选 的 ， 它 包含 了 所 有 已 定义 的 路 由 信 
息 并 能 根据 任何 给 定 的 路 由 来 执行 查找 。 如 果 没 有 定义 路 由 信息 ， 那 么 当 app.get 
或 者 app.post 等 相关 方法 第 一 次 被 调用 时 ， 路 由 信息 会 自动 生成 。 


与 Connect 一 样 Express 中 间 件 的 调用 顺序 也 是 非常 重要 的 。favicon 中 间 件 需要 
在 logger 之 前 调用 ,因为 我 们 不 布 望 日 志 中 包含 一 大 堆 访 问 favicon.ico 的 信息 。static 
中 间 件 应 该 在 bodyParser 以 及 methodOverride 之 前 被 包含 ,因为 处 理 静 态 页 面 时 使 
用 这 两 个 中 间 件 是 没有 意义 的 。Express 应 用 程序 对 表单 的 处 理 是 动态 的 ， 不 适用 
于 静态 页 面 。 


提示 
4, 在 7.4 77 x} Express/Connect 有 更 多 的 介绍 。 


第 二 次 对 configure 方法 的 调用 指定 了 development fest, LATE ASIN errorHandler 3z 
持 。 接 下 来 我 将 介绍 errorHandler 以 及 其 他 一 些 用 于 错误 处 理 的 相关 技术 。 


7.3 ”错误 处 理 
Express 提供 了 错误 处 理 功 能 ， 同 样 也 是 使 用 Connect 的 errorHandler 中 间 件 。 


Connect 的 errorHandler 为 我 们 提供 了 一 种 处 理 异常 的 方法 。 当 异常 产生 时 ， 它 能 
让 我 们 更 好 地 了 解 并 处 理 它 。 可 以 像 包 含 其 他 中 间 件 一 样 使 用 如 下 命令 来 包含 


errorHandler: 
app.use(express.errorHandler()); 

可 以 使 用 dumpExceptions 标志 将 异常 信息 导出 到 stderr: 
app.use(express.errorHandler({dumpExceptions : true })); 

也 还 可 以 使 用 showStack 为 异常 生成 HTML 描述 : 
app.use (express.errorHandler({showStack : true; dumpExceptions : true})); 


再 重申 下 : 这 种 错误 捕获 方法 仅仅 是 给 开发 阶段 使 用 的 , 我 们 绝对 不 希望 真实 用 户 
看 到 这 些 异 销 信 息 。 然 而 , 我 们 却 需要 为 万 一 些 情 况 提 供 有 效 的 错误 处 理 ， 比 如 无 
法 找到 页 面 时 ， 或 者 用 户 试图 访问 一 个 受 限 的 子 目 录 时 。 

这 里 有 一 种 方法 可 以 让 我 们 达到 该 目的 , 那 就 是 使 用 一 个 自 定 义 匿 名 师 数 来 作为 中 
间 件 , 并 将 该 中 间 件 设置 为 处 理 序列 中 的 最 后 一 个 中 间 件 。 如 条 没有 其 他 中 间 件 需 
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要 再 处 理 当前 请 求 的 话 ， 请 求 应 该 可 以 被 正常 地 传递 到 最 后 一 个 中 间 件 。 


app.configure (function () { 
app.use(express.favicon()); 
app.use(express. logger('dev')); 
app.use(express.static( dirname + '/public')); 
app.use(express. bodyParser()); 
app.use(express.methodOverride()); 
app.use(app.router); 
app.use(function(req, res, next) { 

res.send('Sorry ' + req.url + ' does not exist"); 

BE 

DE 


在 下 一 章 中 ， 我 们 将 使 用 模板 来 泻 染 response 对 象 并 生成 一 个 漂亮 的 404 页 面 。 


我 们 还 可 以 使 用 男 外 一 种 方式 来 捕获 程序 抛 出 的 异常 并 做 相应 的 处 理 。 在 Express X 
档 中 ， 将 其 称 为 app.error， 但 在 我 瑟 这 本 书 的 时 候 它 似乎 还 没有 实现 。 不 管 怎 样 ， 通 
过 签名 我 们 可 以 了 解 到 它 是 一 个 包含 4 个 参数 的 图 数 : error, request, response 和 next. 


我 添加 了 第 二 个 用 于 处 理 错误 的 中 间 件 孔 数 ， 同 时 修改 了 之 前 的 404 PERR, 
使 其 抛 出 错误 而 不 是 直接 处 理 错误 : 


app.configure (function () { 
app.use(express.favicon()); 
app.use(express.logger('dev')); 
app.use(express.static( dirname + '/public')); 
app.use(express.bodyParser()); 
app.use(express.methodOverride()); 
app.use(app.router); 
app.use(function(req, res, next) { 
throw new Error(req.url + ' not found'); 
}); 
app.use(function(err, req, res, next) { 
console.log(err) ; 
res.send(err.message) ; 
}); 
Ia 


现在 我 可 以 在 同一 个 函数 中 处 理 404 以 及 其 他 错误 了 。 当 然 , 我 还 可 以 使 用 模板 来 
生成 一 个 更 具 吸 引力 的 页 面 


7.4 Express 5 Connect 的 关系 
纵 观 本 章 , 到 目前 为 止 我 们 已 经 看 到 过 Express 和 Connect 的 协作 关系 。Express iff 


过 Connect 获得 了 很 多 基本 功能 。 


例如 , 可 以 使 用 Connect 中 间 件 cookieParser、cookieSession 和 session 实现 Express 
对 会 话 的 支持 。 但 要 记 住 的 是 必须 使 用 Express 版 本 的 中 间 件 : 


app.use (express.cookieParser ('mumble')}) 
app.use(express.cookieSession({key : 'tracking'})) 


也 可 以 通过 staticCache 中 间 件 来 支持 对 静态 文件 的 缓存 功能 : 


app.use(express.favicon()); 
app.use(express.logger('dev')); 
app.use(express.staticCache()); 
app.use(express.static( dirname + '/public')); 


默认 情况 下 ， 绥 存 模块 最 多 可 以 保存 128 个 对 象 ， 每 个 对 象 最 大 256 KB 空间 , 一 
大 约 32 MB。 可 以 通过 maxObjects 和 maxObjects 两 个 选项 来 调整 这 些 限 制 : 


N 
/ 


app.use(express.staticCache({maxObjects: 100, maxLength: 512})); 
使 用 directory 中 间 件 美化 目录 清单 : 


app.use(express.favicon()); 

app.use(express.logger('dev')); 
app.use(express.staticCache({maxObjects: 100, maxLength: 512})); 
app.use(express.directory(_ dirname + '/public')); 
app.use(express.static( dirname + '/public')); 


如 果 在 使 用 express.directory 的 同时 还 使 用 routing， 务 必 保 证 directory 中 间 件 在 
app.router 中 间 件 之 后 ， 否 则 它 可 能 与 路 由 产生 冲突 。 


一 个 好 的 经 验 法 则 : 将 express.directory 放 到 其 他 中 间 件 之 后 ,任何 错误 处 理 之 前 。 


express.directory 中 间 件 还 文 持 一 些 可 选项 , 包括 是 否 显示 隐藏 文件 ( 默认 为 false ), 
是 否 显示 图 标 (默认 为 false )， 以 及 一 个 过 滤器 。 

提示 

也 可 以 在 Express 中 使 用 Connect 的 第 三 方 中 间 件 。 不 过 ， 当 与 路 由 
一 起 使 用 时 需要 谨慎， 





现在 是 时 候 看 看 Express 的 关键 组 件 : 路 由 。 


7.5 路 由 


所 有 Node 核心 框 桨 ， 事 实 上 也 包括 许多 现代 框 娘 ， 都 实现 了 路 由 的 概念 。 我 在 第 
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6 章 介绍 过 一 个 独立 的 路 由 模块 ， 并 描述 了 如 何 使 用 它 从 URL 中 提取 服务 请 求 。 


Express 是 基于 HTTP 的 GET, PUT, DELETE 以 及 POST 来 管理 路 由 的 ， 同 时 还 
提供 了 对 应 名 字 的 方法 ， 例 如 用 app.get 表示 GET, H app.post 表示 POST。 在 一 
般 的 应 用 程序 中 ， 如 示例 7-1 所 示 ，app.get 方法 被 用 来 访问 程序 的 根 (  )， 该 方法 
同时 还 接收 一 个 请 求 监听 需 以 处 理 请 求 数 据 ， 本 例 中 routes.index 函数 就 是 个 监听 器 。 


routes.index PAR fij- : 


exports.index = function(req, res) { 
res.render('index', { title: 'Express' }); 


站 


它 调 用 了 resource 对 象 上 的 render 方法 。render 方法 需要 提供 模板 文件 名 称 。 由 于 
应 用 程序 已 经 确定 了 视图 引擎 : 


app.set('view engine', 'jade'); 
所 以 我 们 没有 必要 提供 文件 扩展 名 。 当 然 ， 也 可 以 使 用 扩展 名 : 
res.render('index.jade', { title: 'Express' }); 


可 以 在 另 一 个 由 Express 生成 的 文件 夹 views 中 找到 模板 文件 。 它 有 两 个 文件 : 
index.jade 和 layout.jade。index.jade 是 在 render 方法 中 引用 的 模板 文件 , 内容 如 下 : 


extends layout 
block content 
hl= title 
p Welcome to #{title} 


文档 内 容 是 一 个 包含 有 标题 内 容 的 Hl 元 素 , 还 有 一 个 包含 了 title 变量 值 的 段落 元 
素 。layout.jade 模板 提供 了 文档 的 整体 布局 , 包括 head 元 素 中 的 一 个 标题 和 一 个 链 
接 ， 以 及 body 元 素 和 该 元 素 内 的 正文 内 容 : 
html 
head 
title= title 
link(rel='stylesheet', href='/stylesheets/style.css') 


body 
block content 


index.jade 文件 为 layout.jade 文件 中 定义 的 body 提供 实际 内 容 。 
我 会 在 第 8 章 介绍 如 何在 Express 应 用 程序 中 使 用 Jade 模板 以 及 CSS。 
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现在 ， 我 们 来 回顾 下 这 个 应 用 中 都 发 生 了 什么 : 


1. Express 应 用 程序 使 用 app.get KTR iT K% ( routes.index ) 与 一 个 HTTP GET 
请 求 相 关联 起 来 ; 


2. routes.index KOJ res.render 方法 来 呈现 对 应 于 该 GET 请 求 的 响应 内 容 ; 
3. res.render 曙 数 调用 应 用 程序 对 象 的 演 染 功能 ; 


4 应 用 程序 的 演 染 功能 用 于 呈现 指定 的 视图 ， 视 图 中 可 以 包含 有 任何 可 能 的 选项 ， 
本 例 中 我 们 使 用 了 titile; 


5. 注 染 出 的 内 容 被 写 人 到 response 对 象 ， 并 返回 到 用 户 浏 览 器 。 


整个 处 理 过 程 的 最 后 一 步 是 将 生成 的 内 容 作 为 啊 应 消息 写 回 到 浏览 器 。 其 实 ,render 
方法 有 第 三 个 参数 可 以 接收 一 个 回调 函数 。 当 有 任何 错误 发 生 或 者 响应 内 容 准 备 好 
后 ， 该 回调 函数 会 被 调用 。 


由 于 想 仔细 看 看 生成 的 内 容 ， 我 修改 了 route.index 文件 , 将 内 容 文 本 输出 到 控制 台 。 
由 于 用 盖 了 默认 功能 ， 所 以 需要 再 使 用 res.write 图 数 将 生成 的 内 容 发 送 回 浏览 器 ， 
然后 再 调用 res.end 顺 数 表明 传输 完成 。 


exports.index = function(req, res) { 
res.render('index', { title: 'Express' }, function(err, stuff) { 
if (!err) { 


console.log(stuff); 
res.write (stuff); 
res.end(); 
} 
}); 
}; 


正如 我 们 希望 的 那样 ,应 用 程序 现在 能 将 内 容 同 时 输出 到 控制 台 以 及 浏览 器 。 A 
恰 表 明 ， 尽 管 我 们 使 用 的 是 一 个 陌生 的 框架 ， 但 它们 都 是 基于 Node 以 及 Node 提 


供 的 模块 。 当 然 ， 由 于 是 框架 ， 它 必然 也 提供 了 一 些 比 res.write 和 res.end 更 易 用 的 
方法 。 还 有 就 是 ， 在 下 一 节 我 们 会 讨论 与 此 有 更 紧密 联系 的 路 由 路 径 。 


7.5.1 路 由 路 径 

在 示例 7-1 中 ， 我 们 给 出 的 路 由 及 路 由 路 径 是 非常 简单 的 基于 根 地 址 的 。Express 
内 部 会 将 所 有 路 由 编译 成 正则 表达 式 对 象 , 因此 你 可 以 使 用 含有 特殊 字符 的 字符 串 ， 
或 者 直接 在 路 径 字 符 串 中 使 用 正则 表达 式 。 
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为 了 进行 说 明 ,我 在 示例 7-2 中 创建 了 一 个 纯粹 使 用 路 由 路 径 的 应 用 程序 并 监听 三 种 
不 同 的 路 由 。 如 果 有 一 个 请 求 匹 配 到 了 任何 一 个 路 由 项 ， 那 么 我 们 会 使 用 Express 
中 response 对 象 的 send 方法 将 请 求 中 包含 的 参数 返回 给 发 送 方 。 


示例 7-2 测试 不 同 路 由 路 径 模式 
var express = require('express') 
, http = require('http'); 


var app = express(); 


app.configure(function(){ 


3) 


app.get(/*\/node?(?:\/(\d+)(?:\.\.(\d+))?)?/, function(req, res){ 
console. log(req.params); 
res.send(req.params); 


}); 


app-get('/content/*',function(req,res) { 
res.send(req.params); 


})5 


app.get("/products/:id/:operation?", function(reg,res) { 
console. log(req); 
res.send(req.params.operation + ' ' + req.params.id); 


})3 
http. createServer(app).listen(3000) ; 


console. log("Express server listening on port 3000"); 


我 们 无 需 处 理 任 何 视 图 请 求 也 无 需 处 理 任何 静态 内 容 ， 因 此 并 不 需要 在 app.configure 
方法 中 提供 中 间 件 。 然 而 ， 如 果 想 要 正确 地 处 理 不 匹配 任何 路 由 的 请 求 ， 我 们 
确实 需要 调用 app.configure 方法 。 另 外 ， 这 个 程序 默认 使 用 的 是 development 
环境 。 


在 示例 程序 中 ， 第 一 个 app.get 方法 调用 时 使 用 了 正则 表达 式 来 匹配 路 径 。 这 个 正 
则 表达 式 改编 和 目 Express 用 户 手 册 中 的 示例 , 可 以 监听 任何 对 node 的 请 求 。 如 果 请 
求 中 提供 了 独立 或 者 指定 了 范围 的 标识 符 , 则 能 被 request 对 象 捕获 到 参数 列表 中 ， 
参数 列表 随后 会 被 作为 啊 应 内 容 返 回 。 请 求 示例 : 
node 
nodes 
/node/566 


/node/1..10 
/node/50..100/something 


返回 下 面 的 参数 列表 : 
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[null, null] 
[null, null] 
["566", null] 
[A "10"] 
[VOU « VEO 


正则 表达 式 会 寻找 一 个 单一 标识 符 或 一 对 范围 标识 符 ， 在 两 个 数 之 间 使 用 (.. ) 可 以 指 
定 范围 值 , 其 后 的 任何 内 容 都 会 被 忽略 。 如 果 没 有 标识 符 或 范围 设置 , 参数 值 就 为 null。 


处 理 请 求 的 代码 并 没有 使 用 底层 HTTP response 对 象 的 write 和 end 方法 来 将 参数 
返回 给 请 求 者 , 而 是 使 用 Express 的 send 方法 。send 方法 会 为 啊 应 内 容 生成 恰当 的 
消息 头 〈 设 置 数据 类 型 )， 然 后 使 用 底层 的 HTTP end 方法 发 送 消 息 内 容 。 


接 下 来 的 第 二 个 app.get 调用 使 用 了 字符 串 来 定义 路 由 匹配 项 。 在 本 例 中 ， 该 匹配 
项 将 匹配 以 /content 开 始 的 任何 内 容 。 请 求 示 例如 下 : 


/content/156 
/content/this is a story 
/content/apples/oranges 


返回 下 面 的 参数 列表 : 


["156"] 
["this is a-storty”] 
["apples/oranges"] 


星 号 * 表 示 可 以 接受 一 切 content 之 后 的 任何 内 容 。 最 后 一 个 app.get 方法 期 望 匹配 对 
product 信息 的 请 求 。 如 果 请 求 中 有 id 信息 的 话 , 我 们 就 能 通过 params.id 来 直接 访问 它 。 


如 果 请 求 中 还 提供 了 operation 的 话 ， 通 过 params.operation 可 以 直接 访问 它 。 在 一 
个 请 求 中 ， 至 少 应 该 包含 这 两 个 参数 中 的 一 人 个， 当然 也 可 以 同时 包含 两 个 参数 。 


请 求 示例 : 


/products/laptopJK3444445/edit 
/products/fordfocus/add 
/products/add 
/products/tablet89/delete 
/products/ 


相应 的 返回 如 下 结果 : 


edit laptopJK3444445 
add fordfocus 
undefined add 

delete tablet89 
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Cannot GET /products/ 


应 用 程序 会 将 request 对 象 输出 到 控制 台 。 不 过 为 了 能 更 详细 地 查看 request 对 象 ， 
我 将 输出 保存 到 了 output.txt 文件 : 


node app.js > output.txt 


当然 ，request 对 象 就 是 一 个 socket， 在 之 前 对 Node HTTP request 对 象 做 介绍 时 ， 
我 们 已 经 对 它 有 了 很 多 了 解 。 目 前 ， 我 们 主要 感 兴趣 的 是 route 对 象 。 在 程序 接收 
到 一 次 请 求 后 ， 我 们 得 到 了 如 下 有 关 route 对 象 的 输出 信息 : 

route: 


{ path: '/products/:id/:operation?', 
method: '‘'get', 


callbacks: [ [Function] ], 

keys: [ [Object], [Object] ], 

regexp: /*\/products\/(?: ([*\/]+?)) (22\7 ([*\7]+2) ) 2\/2$/i, 
params: [ id: ‘'laptopJK3444445', operation: 'edit' ] }, 


请 注意 到 其 中 生成 的 正则 表达 式 对 象 ， 它 将 我 们 在 请 求 字 符 串 中 使 用 冒号 分 割 的 字 
符 串 转换 成 了 有 意义 的 JavaScript 引擎 可 以 理解 的 正则 表达 式 ( 谢 天 谢 地 了 ， 因 为 
我 的 正则 表达 式 的 确 很 糟糕 )。 


现在 ， 我们 对 路 由 如 何 工 作 应 该 已 经 有 了 更 好 的 理解 ， 再 来 看 看 HTTP 动词 的 使 用 吧 。 
+S ER 
4 如 果 请 求 不 匹配 示例 代码 中 三 个 路 由 项 的 任何 一 个 的 话 ， 将 会 产生 一 
“SAS 个 404 的 响应 : Cannot GET /whatever。 


7.5.2 ”路 由 和 HTTP 动词 

在 前 面 的 例子 中 ， 我 们 使 用 app.get 处 理 传 人 的 请 求 。 这 种 方法 是 基于 HTTPGET 
方法 的 , 在 查询 数据 时 很 有 用 。 如 果 要 输入 数据 或 编辑 删除 现 有 数据 的 话 ， 使 用 这 
种 方法 就 会 碰 到 问题 。 因 此 , 我 们 应 该 使 用 其 他 HTTP 动词 来 创建 一 个 应 用 程序 用 
于 维护 以 及 检索 数据 。 换 句 话 说， 我 们 需要 让 应 用 程序 更 RESTfulo 

提示 

do Ay PG, REST 表示 表述 性 状态 转移 (Representational State 
Transfer ) RESTful 是 一 个 术语 ， 用 来 描述 任何 符合 HTTP 和 REST 
原则 的 Web 应 用 程序 ， 这 些 原则 包括 : 目录 结构 式 的 URL 地址， 无 
状态 ， 数 据 被 包装 为 某 种 互联 网 媒体 类 型 后 传送 (如 ISON), LA 
HTTP 方法 的 使 用 (GET、POST、DELETE 和 PUT ). 
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比方 说 ， 我 们 需要 一 个 管理 widget 的 应 用 程序 。 为 了 创建 一 个 新 的 widget， 那 么 
就 需要 提供 一 个 包含 表单 的 Web 页 面 来 收集 widget 的 具体 信息 。 我 们 可 以 通过 应 
用 程序 自动 生成 这 种 表单 ( 将 在 第 8 章 中 介绍 此 方法 )， 不 过 当前 我 们 使 用 一 个 静 
态 页 面 来 实现 该 表单 ， 如 示例 7-3 所 示 。 


示例 7-3 将 widget 数据 传递 给 Express 应 用 程序 的 HTML 表单 


<!doctype html> 

<html lang="en"> 

<head> 
<meta charset="utf-8" /> 
<title>Widgets</title> 

</head> 

<body> 

<form method="POST" action="/widgets/add" 

enctype="application/x-www-form-urlencoded"> 


<p>Widget name: <input type="text" name="widgetname" id="widgetname" 
size="25" required/></p> 


<p>Widget Price: <input type="text" 
pattern=""\$?([0-9]{1,3},([0-9]{3}, )*[0-9]{3}|[0-9]+)(.[0-9][0-9])?$" 
name="widgetprice", id="widgetprice" size="25" required/></p> 


<p>Widget Description: <br /><textarea name="widgetdesc" id="widgetdesc" 
cols="20" rows="5">No Description</textarea> 
<p> 


<input type="submit" name="submit" id="submit" value="Submit"/> 
<input type="reset" name="reset" id="reset" value="Reset"/> 
</p> 

</form> 

</body> 


这 个 页 面 采 用 了 HTMLS 的 新 特性 required 和 pattern 来 完成 对 输入 数据 的 校 验 。 当 
然 , 这 仅 适 用 于 支持 HTMLS 的 浏览 器 , 这 里 我 会 假设 你 正在 使 用 的 是 支持 HTML 
的 现代 浏览 规 。 


widget 表单 需要 名 字 、 价 钱 (包括 绑 定 在 该 字段 上 的 正则 表达 式 ,， 它 能 根据 pattern 
属性 来 验证 输入 数据 有 效 性 )， 以 及 摘 述 信息 。 基 于 训 览 人 奉 的 验证 功能 确保 了 我 们 
能 够 得 到 这 三 个 值 ， 并 且 价 钱 是 符合 美元 格式 要 求 的 。 


在 该 Express 应 用 程序 中 ,所 有 的 widget 信息 仅仅 保存 在 内 存 中 ,因为 此 刻 我 们 和 硕 
望 把 重点 放 在 纯粹 的 Express 技术 上 。 当 任何 一 个 新 创建 的 widget 被 传递 给 应 用 程 
序 时 ， 应 用 程序 会 通过 app.post 方法 将 它 添 加 到 widget 数组 中 。 可 以 通过 app.get 
方法 来 访问 每 个 widget， 但 需要 传递 该 widget 的 id 值 ， 该 值 在 创建 widget 时 由 程 
序 生 成 。 示 例 7-4 展示 了 所 有 程序 代码 。 
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示例 7-4 用 于 添加 及 显示 widget 的 Express 应 用 程序 


var express = Tequire( "express ' ) 
, http = require('http') 
» app = express(); 


app.configure(function(){ 
app.use(express. favicon()); 
app.use(express. logger('dev')); 
app.use(express.static( dirname + '/public')); 
app.use(express.bodyParser()); 
app.use(app.router) ; 


}); 


app.configure( ‘development’, function(){ 
app.use(express.errorHandler()) ; 


}); 


// in memory data store 
var widgets = [ 
taid- 1; 
name : 'My Special Nidget ， 
price : 100.00, 
descr : 'A widget beyond price' 
} 
] 


// add widget 
app.post('/widgets/add', function(req, res) { 
var indx = widgets. length + 1; 
widgets[widgets. length] = 
{ id : indx, 
name : req.body.widgetname, 
price : parseFloat(req.body.widgetprice), 
descr : req.body.widgetdesc }; 
console.log('added ' + widgets[indx-1]); 
res.send('Widget ' + req.body.widgetname + ' added with id ' + indx); 
}); 
// show widget 
app.get('/widgets/:id', function(req, res) { 
var indx = parseInt(req.params.id) - 1; 
if (!widgets[indx]) 
res.send('There is no widget with id of ' + req.params.id); 
else 
res.send(widgets[indx]); 
}); 


http.createServer(app).listen(3000) ; 
console. log("Express server listening on port 3000"); 
我 们 在 数组 中 保存 了 widget, 以 便 在 没有 做 任何 添加 操作 的 情况 下 可 以 立即 进行 查 


询 操 作 。 如 果 请 求 了 一 个 不 存在 的 widget 是 如 何 处理 的 ? 留意 下 在 app.get 中 的 条 
件 判 断 就 应 该 清楚 了 。 
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运行 这 个 应 用 程序 (示例 代 仙 中 的 example4.js )， 然 后 使 用 “/ ”或 者 “index.html” 
(或 “/example3.html”， 例子 中 的 真实 文件 名 ) 来 访问 包含 有 表单 的 静态 页 面 。 在 
我 们 输入 信息 并 提交 表单 后 会 生成 一 个 页 面 ， 显 示 被 提交 的 widget 信息 以 及 系统 
自动 生成 的 id 值 。 然 后 ， 我 们 就 可 以 使 用 该 id 值 来 查看 widget Lo KIRE, Ai] 
只 是 简单 地 将 widget 对 象 的 内 容 进 行 了 和 输出: 


http://whateverdomain.com: 3000/widgets/2 
这 个 程序 能 工作 ， 但 还 存在 一 个 问题 。 


首先 ， 不 管 是 有 意 还 是 无 意 ， 我 们 可 能 会 在 widget 表单 中 输入 错误 的 信息 。 你 不 
能 在 价格 一 栏 中 输入 除 货币 以 外 的 任何 数据 格式 ,但 是 你 可 以 输入 一 个 错误 的 价 
格 。 你 也 可 能 很 容易 就 键入 错误 的 名 字 或 描述 信息 。 所 以 我 们 需要 文 持 对 widget 
的 更 新 操作 ， 以 解决 这 些 问题 ， 同 样 我 们 也 需要 文 持 对 无 用 widget 的 删除 操作 。 


因此 , 我 们 的 应 用 程序 就 需要 支持 男 外 两 个 RESTful 操作 : PUT Al DELETE. PUT 
用 于 更 新 widget， 而 delete 用 于 删除 widget。 


为 了 要 更 新 指定 widget， 首 先 需 要 显示 一 个 表单 来 展示 widget 的 原 有 数据 ， 以 使 
对 其 进行 编辑 操作 。 要 删除 widget， 我 们 也 需要 一 个 确认 删除 的 表单 。 在 一 般 应 用 
程序 中 , 这 些 都 是 使 用 模板 动态 生成 的 , 但 现在 ,因为 我 们 只 需要 关注 HTTP 动词 
的 使 用 ， 因 此 我 只 创建 了 一 个 静态 页 面 ， 用 于 编辑 及 删除 已 经 创建 的 id 为 1 的 widget。 


下 面 列 出 了 更 新 widget 1 所 使 用 的 表单 代码 。 除 了 将 widget 1 的 具体 内 容 进行 展示 
处 中 ， 表 单 中 还 有 一 个 : 隐藏 域 method， 在 代码 中 以 粗 体 标 注 : 


<form method="POST" action="/widgets/1/update" 
enctype="application/x-www-form-urlencoded"> 


<p>Widget name: <input type="text" name="widgetname" 

id="widgetname" size="25" value="My Special Widget" required/></p> 
<p>Widget Price: <input type="text" 

pattern="*\o 74 10-3) (1. Shy CL0-91 133 4)" 10-9) tor (0-9 )) LL0=9] [0=9) 5-25" 
name="widgetprice" id="widgetprice" size="25" value="100.00" required/></p> 


<p>Widget Description: <br /> 

<textarea name="widgetdesc" id="widgetdesc" cols="20" 
rows="5">A widget beyond price</textarea> 

<p> 


<input type="hidden" value="put" name=" method" /> 
<input type="submit" name="Submit" id="Submit" value="Submit"/> 
<input type="reset" name="reset" id="reset" value="Reset"/> 


</p> 
</form> 
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由 于 表单 属性 并 不 支持 PUT 和 DELETE， 因 此 我 们 使 用 了 名 为 method 的 特殊 隐 
藏 域 来 指定 具体 操作 一 一 是 put 还 是 delete 操作 。 


删除 widget 所 使 用 的 表单 比较 简单 : 它 包 含 了 隐藏 域 method 以 及 一 个 删除 确认 按钮 


<p>Are you sure you want to delete Widget 1?</p> 
<form method="POST" action="/widgets/1/delete" 
enctype="application/x-—www-form-urlencoded"> 


<input type="hidden" value="delete" name=" _ method" /> 


<p> 

<input type="submit” name="submit" id="submit" value="Delete Widget 1"/> 
</p> 

</form> 


为 了 确保 妥善 处 理 HTTP 动词 ， 我 们 需要 为 应 用 程序 添加 另 一 个 中 间 件 express. 
methodOverride ， 并 将 它 紧 随 express.bodyParser 放置 。express.methodOverride 中 间 
件 会 根据 隐藏 字段 的 值 来 修改 当前 请 求 所 使 用 的 HTTP 方法 : 


app.configure (function (){ 
app.use(express.favicon()); 
app.use(express.logger('dev')); 
app.use(express.static( dirname + '/public')); 
app.use(express.bodyParser()); 
app . use (express .methodOverride () ) ; 
app.use(app.router); 


FE RH, 我 们 需要 添加 代码 来 处 理 这 两 种 AT TP 请 求 。 更 新 请 求 会 使 用 新 内 容 蔡 换 
widget 的 旧 内 容 ， 而 删除 请 求 则 会 找到 对 应 的 widget 并 从 列表 中 删除 ， 但 会 留 下 
一 个 空 值 ， 因 为 我 们 不 希望 对 widget 数组 重新 排序 。 


要 完成 这 个 widget 应 用 程序 ， 还 需要 再 添加 一 个 索引 页 面 ， 以 便 用 户 可 以 在 不 指 
定 任 何 标识 或 操作 的 情况 下 就 可 以 访问 widget 列表 。 因 此 ， 索 引 页 要 完成 的 功能 
就 是 将 内 存 中 所 有 widget 罗列 出 来 。 


示例 7-5 展示 了 完成 后 的 应 序 代 码 ， 并 且 所 有 新 添加 的 功能 以 粗 体 文字 显示 。 
示例 7-5 修改 后 的 Widget 应 用 程序 ， 支 持 编辑 和 删除 widget 并 能 列 出 所 有 widget 


var express = require('express') 
, http = require('http') 
» app = express(); 


app. configure(function(){ 
app.use(express. favicon()); 


app.use(express. logger('dev')); 
app.use(express.static( dirname + '/public')); 
app.use(express.bodyParser()); 
app.use(express.methodOverride()); 
app.use(app.router) ; 


}); 


app.configure('development', function(){ 
app.use(express.errorHandler()); 
}); 
// in memory data store 
var widgets = [ 
ts ay 
name : “My Special Widget’, 
price : 100.00, 
descr : 'A widget beyond price’ 
} 
] 


// index for /widgets/ 
app-get('/widgets', function(req, res) { 
res.send(widgets); 


}); 


// show a specific widget 
app.get('/widgets/:id', function(req, res) { 
var indx = parseInt(req.params.id) - 1; 
if (!widgets[indx] ) 
res.send('There is no widget with id of ' + req.params.id); 
else 
res.send(widgets|indx]); 
}); 


// add a widget 
app.post('/widgets/add', function(req, res) { 
var indx = widgets.length + 1; 
widgets[widgets.length] = 
{ id : indx, 
name : req.body.widgetname, 
price : parseFloat(req.body.widgetprice), 
descr : req.body.widgetdesc }; 
console. log(widgets[indx-1]); 
res.send('Widget ' + req.body.widgetname + ' added with id ' + indx); 


I; 


// delete a widget 

app.del('/widgets/:id/delete’, function(req,res) { 
var indx = req.params.id - 1; 
delete widgets[indx] ; 


console.log('deleted ' + req.params.id); 
res.send('deleted ' + req.params.id); 


})5 


// update/edit a widget 
app.put('/widgets/:id/update', function(req,res) { 
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var indx = parseInt(req.params.id) - 1; 
widgets[indx] = 
{ id : indx, 

name : req.body.widgetname, 
price : parseFloat(req.body.widgetprice), 
descr : req.body.widgetdesc }; 

console. log(widgets[indx] ); 

res.send (‘Updated ' + req.params.id); 


})3 


http. createServer (app) .listen(3000) ; 


console. log("Express server listening on port 3000"); 


在 运行 该 应 用 程序 后 ， 我 首先 尝试 添加 widget， 再 罗列 所 有 widget, Ala LH 
id 为 1 的 widget 的 价格 信息 ， 再 删除 它 ， 最 后 再 次 罗列 所 有 widget。 控 制 台 的 
输出 如 下 : 


Express server listening on port 3000 
{ id 2; 
name: 'This is my Baby', 
price: 4.55, 
descr: ‘baby widget' } 
POST /widgets/add 200 4ms 
GET /widgets 200 2ms 
GET /edit.html 304 2ms 
{ id: 0, 
name: 'My Special Widget', 
price: 200, 
descr: 'A widget beyond price' } 
PUT /widgets/1/update 200 2ms 
GET /del.html 304 2ms 
deleted 1 
DELETE /widgets/1/delete 200 3ms 
GET /widgets 200 2ms 


偷 出 信息 中 以 粗 体 标 识 的 部 分 ， 分 别 对 应 HTTP PUT All DELETE 请 求 。 当 我 
第 二 次 列 出 所 有 widget 后 ， 返 回 的 值 是 : 


[ 
null, 
{ 
"id: 27 
"name": "This is my Baby", 
"price: 4.55, 
"descr": "baby widget" 


] 


现在 ， 我 们 有 了 一 个 RESTful 的 Express 应 用 程序 。 但 是 还 存在 另 一 个 问题 。 
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如 果 应 用 程序 只 管理 一 个 对 象 ,那么 把 所 有 功能 塞 进 一 个 文件 或 许 没 有 问题 。 然 而 ， 
大 多 数 的 应 用 程序 都 需要 管理 更 多 的 对 象 , 而 且 所 有 这 些 应 用 的 功能 并 不 会 像 我们 
的 示例 程序 这 样 简 单 。 所 以 ,我 们 还 需要 将 这 个 RESTful 的 Express 应 用 程序 转换 
为 RESTful 的 MVC Express 应 用 程序 。 


7.6 XF MVC 


对 于 一 个 很 小 的 应 用 程序 来 说 ， 将 所 有 实现 代码 集中 放置 在 一 个 文件 中 是 没有 太 大 
问题 的 , 但 大 多 数 应 用 程序 都 需要 更 好 的 组 织 结 构 。MVC 是 一 个 流行 的 软件 染 构 ， 
因此 我 们 希望 在 Express 程序 中 使 用 这 种 架构 来 获取 它 的 优点 。 这 件 事 情 其 实 并 没 
有 看 起 来 的 那么 困难 ， 因 为 我 们 可 以 效仿 Ruby on Rails。 


我 们 可 以 从 Ruby on Rails 获得 许多 有 关 MVC 的 基本 设计 原则 ， 以 便 将 其 引入 并 文 
持 Node 的 MVC 设计 。Express 已 经 采用 了 路 由 的 概念 ( Rails 的 基本 原则 )， 所 以 
我 们 已 经 完成 一 半 MVC 功能 。 现 在 ， 还 需要 提供 第 二 部 功能 ， 即 分 离 的 模型 : 视 
图 和 控制 器 。 控 制 器 会 定义 一 套 动作 以 操作 视图 中 的 每 个 对 象 。 


Rails 提供 多 种 方式 来 将 路 由 信息 (包括 请 求 类 型 及 请 求 路 径 ) 映射 到 相应 的 数 
据 操 作 。 这 个 映射 是 基于 CRUD (create 创建 read 读 取 、update 更 新 和 delete 
删除 ， 它 们 是 持久 存储 所 需要 的 四 个 基本 功能 ) 概念 实现 的 。Rails 的 网 站 提供 
了 一 个 很 好 的 有 关 映 射 的 说 明文 档 ， 我 们 可 以 根据 它 来 为 应 用 程序 创建 映射 。 
我 根据 Rails 的 表格 推导 出 了 表 7-1， 它 展示 我 们 的 widget 应 用 程序 所 需要 的 
映射 。 


表 7-1 widget WRAY REST / route / CRUD 映射 


HTTP verb Ušedfor 
GET 返回 用 于 修改 指定 的 widget 的 HTML 


DELETE /Widgets/id destroy 删除 指定 的 widget 


其 中 的 很 多 功能 我 们 已 经 实现 ,现在 只 需要 把 它 整理 的 干净 一 点 。 
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wo 提示 
只 是 一 个 提醒 : 当 实 现 这 些 与 MVC 相关 的 修改 时 ， 你 可 能 会 碰 到 一 
S 些 与 现 有 中 间 件 冲突 的 问题 。 例 如 ， 当 使 用 directory 中 间 件 提供 目录 
输出 功能 时 , 将 会 与 create 动作 冲突 ,因为 它们 需要 使 用 同一 个 路 由 。 


解决 方法 就 是 将 configure 方法 调用 中 对 express.directory 中 间 件 的 使 
用 放 在 app.router 之 后 。 


首先 , 创建 一 个 controllers 子 目录 ， 并 在 该 日 录 内 新 建 一 个 widgets.js 文件 。 然 后 ， 
将 所 有 有 关 apt.get 和 apt.put 方法 调用 的 代码 复制 到 这 个 新 文件 。 


接 下 来 ,我 们 需要 将 其 转换 为 适合 MVC 格式 的 方法 调用 。 这 意味 着 要 将 现 有 的 每 
个 路 由 方法 调用 转换 为 单独 的 函数 然后 导出 。 例 如 ， 对 于 创建 新 widget 的 函数 : 


// add a widget 
app.post ('/widgets/add', function(req, res) { 
var indx = widgets.length + 1; 
widgets [widgets.length] = 
{ id : indx, 
name : req.body.widgetname, 
price : parseFloat (req.body.widgetprice) }; 
console.log (widgets [indx-1])j; 
res.send('Widget ' + req.body.widgetname + ' added with id ' + indx); 
Vee 


它 将 被 转换 为 widgets.create: 


// add a widget 
exports.create = function(req, res) { 
var indx = widgets.length + 1; 
widgets[widgets.length] = 
{ id : indx, 
name : req.body.widgetname, 
price : parseFloat (req.body.widgetprice)}, 
console.log (widgets [indx-1]); 
res.send('Widget ' + req.body.widgetname + ' added with id ' + indx); 
}; 


转换 后 的 每 个 函数 仍然 需要 request 和 resource 对 象 。 唯 一 的 区 别 是 ， 转 换 后 的 也 
数 中 不 包括 路 由 映射 逻辑 。 


示例 7-6 展示 了 在 controllers 目录 下 的 widgets.js 文件 内 容 。new 和 edit 两 个 方 
法 目前 没有 实现 ， 我 会 在 第 8 章 实现 它们 。 我 们 依然 使 用 内 存 来 存储 widget% 
据 ， 因 为 这 样 能 简化 widget 对 象 ， 同 时 删除 摘 述 字段 可 以 使 应 用 程序 更 容易 进 
行 测试 。 
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示例 7-6 widget 控制 器 


var widgets = [ 
faide 4; 
name : "The Great Widget", 
price : 1000.00 
} 
] 


// index listing of widgets at /widgets/ 
exports.index = function(req, res) { 
res.send(widgets); 


}; 


// display new widget form 
exports.new = function(req, res) { 
res.send('displaying new widget form'); 


i 


// add a widget 
exports.create = function(req, res) { 
var indx = widgets.length + 1; 
widgets[widgets. length] = 
{ id : indx, 
name : req.body.widgetname, 
price : parseFloat(req.body.widgetprice) }; 
console. log(widgets[indx-1]); 
res.send('Widget ' + req.body.widgetname + ' added with id ' + indx); 


}; 


// show a widget 
exports.show = function(req, res) { 
var indx = parseInt(req.params.id) - 1; 
if (!widgets[indx]) 
res.send('There is no widget with id of ' + req.params.id); 
else 
res.send(widgets[indx]); 
}; 


// delete a widget 

exports.destroy = function(req, res) { 
var indx = req.params.id - 1; 
delete widgets[indx]; 


console.log('deleted ' + req.params.id); 
res.send('deleted ' + req.params.id); 


j; 


// display edit form 
exports.edit = function(req, res) { 
res.send('displaying edit form'); 

}; 

// update a widget 

exports.update = function(req, res) { 
var indx = parseInt(req.params.id) - 1; 
widgets[indx] = 
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{ id : indx, 
name : req.body.widgetname, 
price : parseFloat(req.body.widgetprice) } 
console. log(widgets[indx]); 
res.send (‘Updated ' + req.params.id); 
请 注意 , edit 和 new 都 使 用 了 GET 方法 , 他 们 唯一 的 目的 是 呈现 表单 。 相 应 的 ，create 
和 updata 方法 会 真正 去 修改 数据 ， 所 以 前 者 使 用 POST， 而 后 者 使 用 PUT。 
为 了 将 路 由 映射 到 这 些 新 吨 数 上 , 我 创建 了 第 二 个 模块 maproutecontroller, 它 仅 导 
出 了 一 个 函数 mapRoute。 该 困 数 有 两 个 参数 : Express 的 app 对 象 和 一 个 用 于 描述 
控制 右 对 象 的 前 级 (此 处 我 们 使 用 widgets )。 它 使 用 前 级 来 访问 widgets 控制 器 对 


BR, 然后 为 已 知 的 控制 占 方 法 (控制 器 对 象 中 的 方法 集 是 固定 的 ) 做 恰当 的 路 由 映 
射 配置 。 示 例 7-7 显示 了 这 个 新 模块 的 代码 。 


示例 7-7 将 路 由 映射 到 控制 器 方法 
exports.mapRoute = function(app, prefix) { 
prefix = '/' + prefix; 
var prefixObj = require('./controllers/' + prefix); 


// index 
app.get(prefix, prefix0bj.index) ; 


// add 
app.get(prefix + '/new', prefix0bj.new); 


// show 
app.get(prefix + '/:id', prefix0bj.show) ; 


// create 
app.post(prefix + '/create', prefix0bj.create); 


// edit 
app.get(prefix + '/:id/edit', prefix0bj.edit); 


// update 
app.put(prefix + '/:id', prefix0bj.update) ; 


// destroy 
app.del(prefix + '/:id', prefix0bj.destroy) ; 


}; 
mapRoute — PJER HRR, ERR 7-1 中 给 出 的 路 由 可 以 更 容易 地 理解 它 。 


最 后 ,让 我 们 将 这 些 代 码 整 合 起 来 完成 主 应 用 程序 代码 吧 。 谢 天 谢 地 ,代码 清晰 多 
T, 我 们 无 需 再 一 项 项 指定 路 由 方法 调用 了 。 为 了 应 付 对 象 数量 增长 的 可 能 ,我 将 
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每 个 控制 融 的 前 绥 名 统一 放 在 了 一 个 数组 中 。 当 需要 添加 一 个 新 对 象 时 ， 我 只 需要 
问 数组 中 添加 一 个 前 缀 即 可 。 


2?， em 

à Express 自 带 的 MVC 应 用 程序 的 放 在 examples 子 目录 中 。 它 使 用 一 个 

S 例 程 访问 controllers 目录 ， 并 根据 搜索 到 的 文件 名 称 来 推断 前 级 名 。 
通过 这 种 方法 ， 我 们 不 必 改 变 程 序 文件 ， 就 能 添加 一 个 新 的 对 象 。 


示例 7-8 显示 了 完成 后 的 应 用 程序 。 我 将 原先 使 用 的 routes.index WRS FEX, 
还 将 routes/index.js S/F PAM tp “Express” BOCA “Widget Factory”。 


示例 7-8 使 用 了 MVC 架构 的 widget 应 用 程序 


var express = require('express'’ ) 

routes = require('./routes') 

map = require('./maproutecontroller' ) 
http = require('http') 

app = express(); 







A a 


w wv - wv 


app.configure(function(){ 
app.use(express. favicon()); 
app.use(express. logger(‘dev')); 
app.use(express.staticCache({maxObjects: 100, maxLength: 512})); 
app.use(express.static( dirname + '/public')); 
app.use(express.bodyParser()); 
app.use(express.methodOverride()); 
app.use(app.router) ; 
app.use(express.directory(_ dirname + '/public')); 
app.use(function(req, res, next){ 

throw new Error(req.url + ' not found’); 


3 
app.use(function(err, req, res, next) { 
console. log(err) ; 
res.send(err.message) ; 
})5 
}); 


app.configure('development', function(){ 
app.use(express.errorHandler()); 


}); 


app.get('/', routes.index); 
var prefixes = ['widgets']; 


// map route to controller 
prefixes. forEach(function(prefix) { 


map.mapRoute(app, prefix); 
})3 
http. createServer (app). listen(3000) ; 


console. log("Express server listening on port 3000"); 
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现在 代码 看 起 来 即 干 净 又 简单 ,并且 可 扩展 性 更 好 了 。 但 我 们 的 代码 仍然 缺少 MVC 
架构 中 的 视图 部 分 ， 我 会 在 下 一 章 做 介绍 。 


7.7 ”使 用 CURL 测试 Express 应 用 程序 


我 们 可 以 使 用 cURL 苦 代 浏览 器 对 应 用 程序 进行 测试 。 这 个 Unix 工具 对 于 测试 
RESTful 应 用 程序 是 非常 有 用 的 ， 而 且 无 需 创 建 任何 表单 。 


使 用 如 下 cURL 命令 可 以 测试 widgets 索引 页 ( 启动 例子 程序 ,然后 监听 3000 端口 ; 
你 可 能 需要 根据 你 自己 的 配置 环境 对 命令 做 相应 调整 ) 


curl --request GET http://examples.burningbird.net:3000/widgets 


在 request 选项 后 ， 我 们 指定 了 请 求 类 型 ( 本 例 中 为 GET )， 然 后 是 请 求 的 URL 地 
址 。 运 行 命令 后 ， 你 应 该 能 够 获得 当前 所 保存 的 所 有 widget 信息 。 为 了 测试 新 建 
widget 功能 ， 首 先 要 发 送 一 个 创建 新 对 象 的 请 求 : 


curl --request GET http://examples.burningbird.net:3000/widgets/new 


我 们 会 得 到 用 于 收集 widget 信息 的 表单 。 接 下 来 ， 通 过 将 请 求 类 型 改 为 POST 并 
在 请 求 中 指定 widget 数据 ， 就 可 以 测试 添加 widget 了 : 


curl --request POST http://examples.burningbird.net:3000/widgets/create 
--data 'widgetname=Smallwidgetéwidgetprice=10.00' 


所 以 ， 再 次 请 求索 引 页 以 验证 新 的 widge 被 正确 添加 : 
curl --request GET http://examples.burningbird.net:3000/widgets 


结果 应 该 是 : 


"name": "The Great Widget", 
"price": 1000 


Td" Zy 
"name": "Smallwidget", 
"price": 10 


接 下 来 测试 widget 更 新 操作 , 将 价格 修改 为 73.00。 对 应 的 HTTP 请 求 类 型 则 为 PUT: 
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curl --request PUT http://examples.burningbird.net:3000/widgets/2 
--data 'widgetname=Smallwidgeté&widgetprice=75.00' 


在 验证 数据 更 新 成 功 后 , 就 可 以 继续 测试 删除 功能 了 , 注意 使 用 HTTP 的 DELETE 
方法 : 


curl --request DELETE http://examples.burningbird.net:3000/widgets/2 


现在 , 我们 已 经 有 了 MVC 控制 需 组 件 ， 但 还 需要 添加 视图 组 件 ， 这 将 在 第 8 章 中 
详细 介绍 。 不 过 ,在 继续 后 续 内 容 之 前 ， 阅读 下 “其 他 框架 ”说 明 栏 可 以 知道 一 些 
有 用 的 技巧 。 


其 他 框 染 


虽然 Express 是 一 个 框架 , 但 它 却 是 一 个 非常 简单 和 基本 的 框架 。 如 果 你 想 用 它 来 做 更 多 的 事 
( 如 创建 一 个 内 容 管理 系统 )， 还 是 需要 相当 多 的 工作 量 。 


因此 ， 有 一 些 以 Express 为 基础 的 第 三 方 应 用 程序 能 够 为 我 们 提供 更 多 功能 。Calipso 就 是 一 
个 建立 在 Express 之 上 完整 的 内 容 管理 系统 (CMS )， 它 使 用 MongoDB 做 持久 性 存储 。 


而 Express-Resource 是 一 个 小 型 框架 ， 它 为 Express 提供 了 简化 的 MVC 功能 ， 这 样 你 就 不 月 


Tower.js 是 另 一 个 能 够 支持 完整 MVC 的 Web 框架 ， 它 提供 了 一 个 更 高 层次 的 抽象 ， 并 且 以 
Ruby on Rails 为 原型 。RailwayJS 也 是 一 个 MVC 框架 ， 基 于 Express 并 仿照 Ruby on Rails. 
还 有 一 个 名 为 Strata 的 框架 ， 它 采取 了 与 Towerjs 和 RailwayJS 不 同 的 策略 。 它 遵循 由 WSGI 
( Python ) 和 Rack ( Ruby ) 建立 的 模型 ， 而 不 是 Rails 模型 。 这 是 一 个 低级 别 的 抽象 ， 如 果 你 
没有 Ruby 和 Rails 编程 工作 经 验 ， 使 用 它 会 更 简单 些 。 
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Express, ima CSS 


类 似 Rexpress 这 种 架构 提供 了 很 多 有 用 的 功能 ， 但 是 并 没有 提供 一 种 将 数据 与 数 
据 呈 现 分 开 的 方法 。 你 可 以 使 用 JavaScript 生成 HTML 文件 的 方式 处 理 查询 或 者 修 
改 结果 , 但 是 工作 量 很 快 就 变 得 不 可 估量 ,特别 是 如 果 你 想 要 生成 页 面 的 各 个 部 分 ， 
包括 侧 边栏 、 页 首 、 页 脚 等 。 当 然 ， 你 也 可 以 使 用 一 些 果 数 ,， 但 是 这 个 工作 量 也 足 
够 让 你 朋 演 了 。 

IBN A, 当 架 构 系 统 开发 出 来 的 时 修 , 模板 系统 也 会 随 之 产生 , 对 Node 和 Express 
来 说 也 是 如 此 。 在 第 TP, 我们 主要 使 用 了 Express 默认 安装 的 模板 系统 Jade, 
包括 男 一 个 很 流行 的 组 件 EJS (embedded JavaScript, it Ax JavaScript )。Jade 和 
EJS 采用 了 完全 不 同 的 实现 方式 ， 但 是 都 实现 了 相同 的 结果 。 

同时 ， 在 传统 方式 中 你 可 以 为 自己 的 网 站 或 者 应 用 程序 手动 创建 CSS 文件 ， 现 在 
你 也 可 以 使 用 CSS 引擎 ， 简 化 网 页 的 设计 和 开发 。 你 需要 一 个 简单 的 结构 易于 编 
CSS, 而 不 是 每 次 都 要 目 己 输入 花 括 号 和 分 号 。 一 个 可 以 与 Express 和 其 他 Node 
应 用 完美 融合 的 CSS 引擎 叫做 Stylus. 

在 本 章 中 ,我 主要 关注 Jade， 因 为 它 是 由 Express 默认 安装 的 。 但 是 我 也 会 大 概 介 
绍 一 下 EJS， 这 样 你 就 可 以 看 出 来 两 个 模板 系统 的 差别 以 及 了 解 它 们 是 如 何 工 作 
的 。 同 时 我 还 会 介绍 一 下 Stylus 是 如 何 管理 CSS 以 保证 页 面 正确 显示 的 。 


8.1 EJS 模板 系统 (Embedded JavaScript Template 
System) 


对 于 EJF Æi, ite Ask JavaScript 是 个 好 名 字 ， 很 好 地 表述 和 EJS 是 如 何 工作 的 : 
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HxTE HTML 标志 中 的 JavaScript, 用 于 融合 数据 和 HTML 文档 结构 。EJS 是 一 个 基 
F Ruby ERB (embedded Ruby ) 的 简单 模板 系统 。 


N 提示 
EJS GitHub 页 面 : https://github.com/visionmedia/ejs. 


8.1.1 ”基本 语法 


如 果 你 用 过 很 多 CMS ( 内 容 管理 系统 ，Content Management System )， 你 很 快 就 能 
理解 EJS 的 基本 原理 。 以 下 代码 是 EJS 模板 的 一 个 示例 : 
<% if (names.length) { %> 
<ul> 
<% names.forEach(function(name) { %> 
<1li><%= name %></1li> 
<% }) %> 
</ul> 
<% } $> 


在 代码 中 ，EJS HIRA HTML 中 ,在 本 例 中 用 于 提供 数据 给 独立 的 无 序列 表 
项 。 尖 括号 和 百 分 号 组 成 的 符号 对 (<% , %> ) 用 于 表达 EJS: 条 件 表达 式 用 于 确 
保 数 组 存在 ， 之 后 JavaScript 对 数组 进行 处 理 ， 输 出 数组 中 每 一 项 的 值 。 


wa, 提示 
EJS 是 基于 Ruby ERB 的 模板 系统 ， 这 就 是 为 什么 你 会 经 常 看 到 用 “类 
Serb” RMT ER. 


itl} AEA SES, EK “HELA T ED BAIA” : 
当 打印 出 来 的 时 候 ， 该 值 转 义 了 ,要 打印 出 来 转 义 的 值 ,使 用 一 个 间隔 符 ,如 下 所 示 : 


可 能 有 时 候 你 并 不 想 使 用 表述 EJS 的 开 闭 标志 (<%, %> ) ,你 可 以 通过 EIS 对 象 提 
供 的 open, close 方法 目 定 义 标 识 符 : 


ejs.open('<<'); 
ejs.close('>>'); 


SR a ty HEH AE SC RAY : 


<hil><<=title >></hl> 
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不 过 除非 你 坚持 如 此 ， 还 是 推荐 使 用 默认 的 符号 。 
尽管 是 EJS te AZE HTML 中 的 , 但 它 还 是 JavaScript， 所 以 你 需要 提供 开 闭 的 花 括 
号 ， 并 且 在 使 用 array 对 象 的 forEach 方法 时 保持 适当 的 格式 。 


作为 完整 的 产品 ，HTML 会 通过 EJS 顶 数 调用 进行 泻 染 ， 返 回 一 个 可 以 生成 结果 
的 JavaScript 函数 ， 或 者 直接 生成 最 终结 果 。 当 我 们 为 Node 安装 好 EJS 后 我 会 详 
细 说 明 这 一 点 。 现 在 就 来 完成 安装 吧 。 


8.1.2 Node 5 EJS 


我 们 需要 安装 的 模块 是 与 Node 兼容 的 EJS 版 本 。 它 与 你 直接 在 EJS 官网 下 载 的 不 
是 同一 个 东西 。Node EJS 可 以 用 于 客户 问 JavaScript, 但 是 我 们 只 关注 如 何在 Node 
程序 中 使 用 它 。 
npm 安装 该 模块 : 

npm install ejs 


EJS 安装 完成 后 ， 就 可 以 直接 在 一 般 的 Node 程序 中 使 用 了 ， 并 不 一 定 需要 类 似 
Express 的 架构 。 作 为 例子 ， 以 下 代码 说 明了 从 模板 文件 如 何 生 成 HTML: 


<html> 
<head> 
<title><%= title %></title> 
</head> 
<body> 
<% if (names.length) { %> 
<ul> 
<% names.forEFach(function(name){ %> 
<li><%= name %></1li> 
<% }) 5> 
</ul> 
<5% } %> 
</body> 


直接 调用 EJS 对 象 的 renderFile 方法 ， 这样 做 会 打开 模板 文件 并 用 提供 的 数据 作为 
参数 生成 HTML。 


示例 8-1 使 用 Node 提供 的 标准 HTTP IRS Ar, 在 端口 8124 上 监听 请 求 。 当 收 到 请 
求 时 ， 程 序 会 调用 EJS 的 renderFile 方法 ， 将 模板 文件 的 路 径 、names 数组 和 文档 
的 title 作为 参数 传递 进去 。 最 后 一 个 参数 是 回调 顺 数 ， 显 示 错 误 (可 以 阅读 的 错误 
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RE ) 或 者 返回 生成 的 HTML。 在 该 例子 中 , 如 果 没有 错误 发 生 结果 则 会 通过 response 
发 送 回去 。 如 果 出 错 ， 错 误 信息 会 被 加 载 到 结果 中 ， 错 误 对 象 内 容 输出 到 控制 人 台 。 


示例 8-1 根据 数据 和 EJS 模板 生成 HTML 


var http = require('http') 
, ejs = require('ejs') 


// 创建 HTTP 服务 器 


http.createServer(function (req, res) { 


res.writeHead(200, {'content-type':'text/html1'}); 


// 加 载 数 据 
var names = ['Joe', 'Mary', 'Sue', 'Mark']; 
var title = 'Testing EJS'; 


// 生成 或 者 处 理 错 误 信 a Į 
ejs.renderFile( dirname + '/views/test.ejs', 
{title:'testing', names:names}, 
function (err, result) { 
if (!err) { 
res.end(result); 
} else { 
res.end('An error occurred accessing page'); 
console.log(err); 
} 
} ) 
}) -listen(8124); 
console.log('Server running on 8124/'); 


另外 一 种 rendering 方法 是 render, PEW EJS 模板 作为 字符 串 类 型 参数 ， 返 回 生 成 
好 的 HTML: 


var str = fs.readFileSync( dirname + '/view/test.ejs', 'utf8'); 
var html = ejs.render(str, {name : names, title: title}); 


res.end(html); 


第 三 种 rendering 的 方式 是 compile, Belk EJS 模板 字符 串 并 返回 可 以 生成 HTML 
的 JavaScript 方法 供 调 用 。 我 不 会 对 这 一 方法 做 说 明 , 但 是 你 可 以 使 用 这 种 方法 在 
Node 客户 端 程 序 中 使 用 EJS。 

提示 

Compile 的 用 法 会 在 9.2 节 介 绍 
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8.1.3 EJS 5 Node Filters 


SRY EJS 模板 外 ，Node EJS 还 提供 了 一 系列 预先 定义 的 filter， 可 以 进 一 
步 地 简化 HTML 的 生成 过 程 。 比 如 ， 一 个 名 为 first 的 filter， 对 给 定 的 数组 可 以 取 
出 第 一 个 值 。 另 一 个 fliter 一 一 downcase， 接 收 first filter 的 结果 并 改 为 小 写 : 


var names = ['Joe Brown', 'Mary Smith', 'Tom Thumb', 'Cinder Ella']; 
var str = '<p><%=: users | first | downcase %></p>'; 
var html = ejs.render(str, {users:names }); 

HRN: 


<p>joe brown</p> 


filters 可 以 链 式 调用 ， 上 一 个 filter 的 结果 会 传递 给 下 一 个 作为 参数 。filter 的 使 用 
由 等 号 之 后 紧 跟 的 冒号 触发 ,之 后 跟着 数据 对 和 象 。 以 下 代码 的 示例 接收 一 系列 
people 对 象 为 参数 ,构造 一 个 新 的 对 象 仪 有 peaple 的 名 字 构 成 , 按 名 字 排 序 ， 并 输 
出 由 名 字 拼 接 好 的 字符 串 : 
var people = [ 

{name:'Joe Brown', age:32}, 

{name:'Mary Smith', age:54}, 

{name:'Tom Thumb', age:21}, 

{name:'Cinder Ella’, age:16}]; 


var str = "<p><%=: people | map:'name' | sort | join %></p>"; 
var html = ejs.render(str, {people:people }); 


filter 组 合 使 用 的 结果 如 下 : 

Cinder Ella, Joe Brown, Mary Smith, Tom Thumb 
filters 并 没有 记录 在 Node EJS 的 文档 中 ， 在 交换 顺序 使 用 这 些 filter 时 必须 特别 小 
心 ， 因 为 一 些 filter 需要 string 作为 参数 ， 而 不 是 数组 对 象 。 表 8-1 包含 了 一 系列 的 
filter， 并 简要 说 明了 该 filter 需要 的 数据 类 型 以 及 作用 。 

表 8-1 Node EJS filters 


Filter 数据 类 型 作 用 
first 接收 并 返回 数组 返回 数组 第 一 个 元 素 





last 接收 并 返回 数组 返回 数组 最 后 一 个 元 素 
capitalize Fak lel 字符 串 第 一 个 字母 大 写 
downcasa 接收 并 返回 字符 串 字符 串 全 部 转换 为 小 写 
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Filter 数据 类 型 作 用 


upcase 接收 并 返回 字符 串 字符 串 全 部 转换 为 大 写 

sort 接收 并 返回 数组 对 数组 应 用 Array.sort 方法 
tet, spies 创建 自 定义 的 排序 方法 ， 根 据 

sort_bt:’prop 接收 数组 和 属性 名 称 ;， 返回 数组 属性 对 数组 排序 


Size 接收 数组 ;返回 数值 返回 Array.length 
Plus:n 接收 两 个 数字 或 者 字符 串 ， 返回 数值 返回 a+b 
Minus:n 接收 两 个 数值 或 者 字符 串 ， 返回 数值 返回 b-a 















Times:n 接收 两 个 数值 或 者 字符 串 ， 返回 数值 返回 a*b 
Devided by:n 接收 两 个 数值 或 者 字符 串 ， 返 回 数值 返回 a/b 
Join: ‘val 接收 数组 ， 返 回 字符 串 penne 


truncate:n 接收 字符 串 和 长 度数 值 ， 返 回 字符 串 引用 String.substr 
truncate words:n | 接收 字符 串 和 单词 数 ， 人 返回 字符 串 应 用 String.spit,String.splice 


Replace:pattem， | 接收 字符 串 、 模 版 和 替换 内 容 ， 返回 字 符 串 | 应 用 String.replace 
substitution 

Prepend:value 接收 字符 串 和 value 字符 串 ; REFI | 把 value 加 在 字符 串 之 前 
Append:value 接收 字符 串 和 value FFP, 返回 字符 串 | 把 value 拼 在 字符 串 之 后 


Mes apna eve. 用 Array.map 方法 根据 给 定 对 
Map:’prop PEW FF EB ABE; e 828 Se Fak ll a8 er HE 


如 果 是 数组 ， 应 用 Array.reverse 
Reverse 接收 数组 或 者 字符 串 如 果 是 字符 串 ， 分 解 单词 ， 翻 
转 ， 再 拼接 


Get 接收 对 象 和 属性 返回 给 定 对 象 的 该 属性 值 
Json 接收 对 象 转换 为 ISON 字符 串 


8.2 在 Express 中 使 用 EJS 


模板 系统 提供 了 MVC ( Model-View-Controller ) 应 用 程序 (在 第 7 音 中 介绍 过 这 种 
架构 ) 中 view 部 分 我 们 需要 的 部 分 。 

提示 

MVC 的 model 部 分 会 在 第 10 章 中 介绍 。 
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在 第 7 章 示 例 7-1 中 ,我 简单 介绍 了 关于 模板 系统 的 用 法 。 该 例子 使 用 Jade, 但 是 
我 们 很 容易 可 以 转换 为 EJS。 有 多 简单 呢 ? 示例 8-2 基本 是 示例 7-1 的 一 个 复制 ， 
除了 使 用 EJS 替代 Jade。 准 确 的 说 只 有 一 行 变动 了 ， 用 粗 体 标 了 出 来 。 


示例 8-2 在 应 用 程序 中 使 用 EJS 作为 模板 系统 


var express = require('express') 
,routes = require('./routes') 
http = require('http'); 

var app = express(); 


app.configure(function () { 
app.set('views', dirname + '/views'); 
app.set('view engine', ‘ejs'); 
app.use(express.favicon()); 
app.use(express.logger('dev')); 
app.use(express.static( dirname + '/public')); 
app.use(express.bodyParser()); 
app.use (express .methodOverride()); 
app.use(app.router); 


app.configure('development', function () { 
app.use(express.errorHandler()); 
}); 


app.get('/', routes.index); 
http.createServer (app) .listen(3000) ; 


console.log("Express server listening on port 3000"); 


index.js 路 由 并 没有 任何 改变 ,因为 它 并 没有 使 用 任何 与 模板 系统 有 关 的 内 容 ， 只 使 用 
了 Express resource 对 象 的 render 方法 ， 这 与 模板 系统 无 关 ( 只 要 系统 兼容 Express ): 
exports.index = function (req, res) { 
res.render('index', { title:'Express' }, function (err, stuff) { 
if (!err) { 
console.log(stuff); 


res.write(stuff); 
res.end(); 


}); 
}3 


在 views 目录 下 index.ejs 文件 (注意 扩展 名 ) EH Node EJS 标注 替代 了 第 7 章 中 
我 们 看 到 的 Jade: 


<html> 
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<head> 

<title><%= title %></title> 

</head> 

<body> 

<hl><%= title %></title> 

<p>Welcome to<%= title %></p> 

</body> 
这 段 代码 显示 了 在 程序 中 将 model, controller, view 分 离 是 一 件 多 么 美好 的 事情 : 
你 可 以 切换 所 使 用 的 技术 ,比如 使 用 不 同 的 模板 系统 , 而 不 会 影响 到 应 用 程序 的 逻 
辑 或 者 数据 访问 。 


简单 回顾 一 下 这 个 程序 的 过 程 : 


1. Express 核心 程序 使 用 app.get 将 一 个 请 求 监听 方法 (routes.index ) 与 HTTP Get 
请 求 联 系 起 来 ; 


2. routes.index 方法 调用 res.render 方法 来 为 请 求生 成 响应 ; 

3. res.render 方法 唤醒 程序 对 象 的 render 方法 ; 

4. 程序 的 render 方法 根据 选项 内 容 一 一 本 例 中 是 title 一 一 找到 特定 的 view; 
5， 需 要 被 演 染 的 内 容 被 写 入 response 对 象 ， 然 后 返回 到 用 户 浏 览 器 上 。 


在 第 7 章 中 , 我 们 主要 关注 了 程序 的 路 由 方面 , 现在 我 们 需要 关注 视图 。 我们 使 用 
第 7 章 最 后 示例 7-6 到 示例 7-8 所 创建 的 程序 ， 对 其 添加 视图 。 但 首先 需要 对 环境 
做 一 些小 改变 来 确保 程序 可 以 按照 我 们 需要 的 方向 继续 发 展 。 


8.2.1 多 对 和 象 环境 的 改造 


尽管 程序 被 称 为 Widget Factory， 但 是 widget 并 不 是 该 程序 唯一 的 产品 。 我 们 需要 
对 环境 进行 改造 来 添加 需要 的 对 象 。 


现在 ， 结 构 如 下 : 


/application 目录 
/routes 一 controller MAKER 
/controllers -对 象 的 controller 
/public -静态 文件 
/views -模版 文件 


routes 和 controllers 目录 保留 不 变 , views 和 public 目录 需要 修改 , 以 允许 不 同 对 象 
存在 。 为 了 不 把 所 有 widget 都 放 在 views RAX F, 我们 在 views 下 添加 一 个 子 目 
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录 来 放置 所 有 widgets: 


/application 目录 
/views 
/widgets 
同样 ， 为 了 不 把 widget 静态 文件 放 在 public 目录 下 ， 创 建 一 个 子 目 录 widget 在 public 
目录 下 : 
/application Bx 
/public 
/widgets 
现在 我 们 可 以 通过 添加 新 的 目录 来 添加 新 的 对 象 , 而 且 对 每 一 个 对 象 都 可 以 使 用 类 
似 new.html 和 edit.ejs 的 文件 名 而 不 会 引发 新 文件 覆盖 旧 文 件 的 问题 。 


注意 到 这 种 结构 假定 了 我 们 的 应 用 程序 中 存在 静态 文件 .下 一 步 需 要 做 的 是 找到 如 
何 将 静态 文件 与 新 的 动态 环境 集成 的 问题 。 


8.2.2 ”静态 文件 路 由 


应 用 程序 第 一 个 需要 修改 的 部 分 就 是 添加 一 个 新 的 widget。 它 包括 两 个 部 分 : 显 
示 一 个 可 以 获取 新 的 widget 信息 的 表单 和 将 新 的 widget 存储 在 已 有 的 widget 数 
据 存 储 中 。 


我 们 可 以 为 需要 的 表单 创建 一 个 EJS 模板 , 但 是 它 并 不 包含 任何 动态 的 部 分 , 或 者 
说 ,至 少 在 页 面 设计 这 个 点 上 没有 。 所 以 , 通过 模板 系统 为 某 部 分 提供 服务 , 但 是 
该 部 分 并 不 需要 模板 系统 的 功能 ， 这 是 没有 意义 的 事情 。 


我 们 可 以 仅仅 改变 表单 访问 方式 来 完成 这 一 功能 ， 通 过 访问 /widgetsmnew.html 来 访 
问 表单 ， 替 代 之 前 的 /widgetsnew。 但 是 这 会 导致 程序 中 路 由 表达 的 不 一 致 。 如 果 
我 们 后 面 再 为 该 表单 页 面 添加 动态 组 件 ， 需 要 修改 指向 新 表单 的 方式 。 


一 个 好 的 实现 方式 是 按照 处 理 动 态 文件 的 方式 来 处 理 请 求 和 静态 页 面 ， 但 是 不 经 过 
模版 系统 。 


Express resource 对 象 有 个 redirect 方法 可 以 用 于 将 请 求 重 定 同 到 new.htm1， 但 是 
new.html 会 在 处 理 结束 时 显示 在 浏览 需 的 地 址 栏 中 ,同时 也 会 返回 302 状态 码 , 我 
们 并 不 希望 看 到 这 一 点 。 所 以 , 我 们 使 用 resource 对 象 的 sendfile 方法 蔡 代 。Sendfile 
方法 接收 一 个 文件 路 径 作 为 参数 ， 可 能 的 选项 值 ， 以 及 一 个 只 有 error 作为 参数 的 
回调 函数 ， 该 回调 函数 可 选 。Widget controller 只 使 用 第 一 个 参数 。 
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文件 路 径 为 : 
= dirname + "/../public/widgets/widget.html" 


我 们 使 用 相对 路 径 符号 “..”， 因 为 public 目录 与 controller 目录 的 上 一 级 平行 。 但 
是 在 sendfile 方法 中 并 不 能 这 样 使 用 路 径 , 这 会 产生 403 错误 的 状态 公 。 作为 替代 ， 
我 们 使 用 path 模块 的 normalize 方法 将 相对 路 径 转 换 为 对 应 的 绝对 路 径 。 


// 显 示 新 的 widget 表单 
exports.new = function(reg, res) { 
var filepath = require('path').normalize( dirname + 


"/../public/widgets/new.html1") ; 
res.sendfile(filepath); 


}? 


这 个 表单 的 HTML 没有 什么 惊喜 ， 只 是 一 个 简单 的 表单 ， 如 示例 8-3 所 示 。 但 是 ， 
我 们 添加 了 description 区 域 来 使 数据 更 有 趣 一 点 。 


示例 8-3 HTML 新 widget 表单 


<!doctype html> 

<html lang="en"> 

<head> 

<meta charset="utf-8"/> 
<title>Widgets</title> 
</head> 

<body> 

<h1>Add Widget:</hl1> 


<form method="POST" action="/widgets/create" 
enctype="application/x-—www-form-urlencoded"> 


<p>Widget name: <input type="text" name="widgetname" 

id="widgetname" size="25" required/></p> 

<p>Widget Price: <input type="text" 
pattern=""\52(10-9) (173), (0=91137 9) *10=9) 13) | [0-9)4+) (10-9) [0-9] )' 25" 
name="widgetprice” id="widgetprice" size="25" required/> </p> 


<p>Widget Description: <br/> 

<textarea name="widgetdesc" id="widgetdesc" cols="20" 
rows="5"></textarea> 

<p> 


<input type="submit" name="Submit" id="sSubmit" value="Submit"/> 


<input type="reset" name="reset"™ id="reset" value="Reset"/> 
</p> 
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</form> 
</body> 


表单 的 方法 肯定 是 POST. 


现在 程序 可 以 显示 一 个 创建 新 widget 的 表单 了 ， 我 们 需要 修改 widget controller 来 
处 理 表 单 的 post 过 程 。 


a 提示 
还 有 一 个 Express 的 扩展 模块 一 一 express-rewrite， 提 供 URL 重 定向 功 


S 能 。 用 以 下 命令 可 以 安装 : 


npm install express-rewirte 


8.2.3 处理 一 个 新 对 象 的 Post 请 求 


我 们 需要 修改 程序 的 主要 文件 来 兼容 使 用 EJS 模板 系统 ， 这 上 比 添加 新 的 可 以 支持 的 
横 板 优先 级 更 高 。 我 不 会 完全 重复 第 7 章 中 示例 7-8 的 app.js 文件 ， 因 为 修改 仅仅 
在 configure 方法 调用 包含 EIS 模板 引擎 和 views 目录 中 : 


app.configure(function () { 
app.set('views', _ dirname + '/views'); 
app.set('view engine', 'ejs'); 
app.use(express.favicon()); 
app.use(express.logger('dev')); 
app.use(express.staticCache({maxObjects:100, maxLength:512})); 
app.use(express.static( dirname + '/public')); 
app.use(express.bodyParser()); 
app.use (express.methodOverride()); 
app.use(app.router); 
app.use(express.directory( dirname + '/public')); 
app.use(function (req, res, next) { 
throw new Error (req.url + ' not found'); 
J)? 
app.use (function (err, req, res, next) { 
console.log (err); 
res.send(err.message) ; 
} ) 7 
} ) ; 


现在 我 们 准备 好 转换 widget controller 使 用 模板 了 ， 从 添加 一 个 新 的 widget 开始 。 


事实 上 ，Widget controller 中 对 一 个 新 的 widget 的 处 理 过 程 并 没有 变化 。 我 们 依然 
从 request 内容 中 获取 数据 ， 添 加 到 widget 存储 中 。 不 同 之 处 在 于 ， 我 们 已 经 可 以 
访问 模板 系统 ， 需 要 修改 的 是 我 们 如 何 回应 成 功 添加 的 一 个 新 的 widget. 
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我 创建 了 一 个 新 的 EIS 模板 一 一 added.js， 如 示例 8-4 所 示 。 该 文件 所 做 的 就 是 提 
供 一 系列 widget 的 属性 和 一 个 由 widget 对 象 的 title 组 成 的 消息 。 


示例 8-4 “Widget added” 确 认 信 息 模 板 


<head> 

<title><%= title %></title> 

</head> 

<body> 

<hl><%= title %> | <%= widget.name %></hl1> 
<ul> 


<li>ID: <%= widget.id %></li> 

<li>Name: <%= widget.name %></li> 

<li>Price: <%= widget.price.toFixed(2) %></li> 
<li>Desc: <%= widget.desc %></li> 

</ul> 

</body> 


update 的 处 理 过 程 与 第 7 章 中 显示 的 略 有 不 同 ， 我 们 现在 会 返回 给 用 户 一 个 视图 而 
不 是 简单 的 消息 (修改 的 部 分 用 粗 体 标 出 )。 


// 添加 一 个 widget 
exports.create = function (req, res) { 


// 获取 widget id 
var indx = widgets.length + 1; 


// 添加 widget 
widgets [widgets.length] = 
{id : indx, 
name : req.body.widgetname, 
price : parseFloat (req.body.widgetprice), 
desc : req.body.widgetdesc}; 


// 输 出 到 控制 台 并 对 用 户 确认 添加 信息 

console.log (widgets [indx-1]); 

res.render ('widgets/added', {title: 'Widget Added' , widget:widgets [indx - 1] }) ; 
be 


发 送 给 视图 的 两 个 选项 分 别 是 页 面 title 和 widget WH. Al 8-1 显示 了 该 信息 ， 目 前 
还 是 文本 描述 形式 。 


a 提示 
ky 处 理 新 widget 的 过 程 并 没有 对 数据 做 任何 验证 或 者 检查 SQL 注入 侵 
> 害 。 数 据 验 证 ， 安 全 以 及 权限 问题 在 第 15 章 中 涉及 。 
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| 4@ Widget Added 


‘Added Second Wiee 


* ID-2 

© Name: Second Widget 

* Price: 23.99 

+ Desc: The second widget from our widget factory. 





图 8-1 添加 widget 后 的 确认 信息 


接 下 来 转换 为 模板 的 两 个 过 程 是 update( 更 新 ) 和 deletion( 删除 )， 需 要 一 种 方式 确 
定 操作 在 哪个 widget 上 执行 。 同 时 ， 我们 也 需要 使 index 显示 所 有 的 widget。 在 这 三 
个 过 程 中 ， 我 们 将 会 使 用 一 个 视图 创建 widget 索引 页 面 和 选用 列表 ， 接 下 来 会 介绍 。 


8.2.4 Widget 索引 和 生成 picklist 


picklist ( 选用 列表 ) 就 是 指 一 系列 可 供 选 择 的 选项 列表 。 对 于 widget 程序 来 说 ，picklist 
可 能 此 是 一 个 集成 在 更 新 或 者 删除 页 面 的 选择 区 域 或 者 下 拉 列 表 ， 使 用 Ajax 或 者 客户 端 
脚本 语言 实现 。 但 是 ， 我 人 ] 将 要 完成 的 是 将 该 功能 集成 在 £ widget 程序 的 index 页 面 中 。 


现在 的 widget index 页 面 仅 显示 widget 数据 存储 中 的 数据 。 信 息 量 很 大 , 但 是 不 易 
阅读 没有 太 大 实际 用 处 。 为 了 改进 这 一 部 分 , 我 们 需要 添加 一 个 新 的 视图 来 显示 数 
据 表 中 所 有 的 widget， 每 个 widget 一 行 ， 由 widget 属性 组 成 。 还 需要 添加 两 个 新 
的 列 ， 一 列 链接 到 对 该 widget 的 修改 ， 夯 一 列 用 于 删除 。 这 些 补 全 了 程序 缺少 的 
部 分 : 不 需要 记 住 widget id 可 以 编辑 或 删除 某 个 widget 的 方式 。 


示例 8-5 为 需要 的 新 视图 模板 的 内 容 ， 名 为 index.ejs。 该 文件 在 widgets 子 目录 下 ， 
所 以 我 们 不 需要 担心 它 是 否 与 更 高 层 的 index.ejs 重 名 。 


示例 8-5 Widgets index 页 面 ， 每 个 widgets 带 有 编辑 和 删除 链接 


<!doctype html> 

<html lang="en"> 

<head> 

<meta charset="utf-8"/> 
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<title><%= title %></title> 
</head> 
<body> 
% if (widgets.length) { %> 
<table> 
<caption>Widgets</caption> 
<tr><th>ID</th><th>Name</th><th>Price</th><th>Description</th></tr> 
% widgets. forEach (function (widget) { %> 
<ET> 
<td><%= widget.id %></td> 
<td><%= widget.name %></td> 
<td>$<%= widget.price.toFixed(2) %></td> 
<td><%= widget.desc %></td> 
<td><a href="/widgets/<%= widget.id %>/edit">Edit</a></td> 
<td><a href="/widgets/<%= widget.id %>">Delete</a></td> 
</tr> 
<% }) %> 
</table> 
<% } %> 
</body> 
</html> 


controller 部 分 用 于 触发 新 视图 调用 的 代码 相当 简单 : 只 需要 调用 render 方法 ， 将 
所 有 widget 组 成 的 数组 作为 参数 : 


// 访 问 /widgets 显示 所 有 widgets 的 索引 


exports.index = function(req, res) { 
res.render ('widgets/index', {title: 'Widgets', widgets: widgets}); 
}; 


示例 8-5 中 ， 如 果 对 象 有 length 属性 (说明 对 象 为 数组 )， 该 元 素 对 象 会 被 遍历 ， 
属性 会 输出 到 表格 中 ， 同 时 还 有 编辑 和 删除 链接 。 图 8-2 显示 存储 了 几 个 widget 
之 后 的 表格 信息 。 














l N Widgets . o 

K> C 5 examples.bumingbird.net: 3990 /w:daets/ Ts © yy 
Widgets 

wD Name Price Description 

| 1 The Great Widget $1000.00 A widget of great value Edit Delete 

| 2 Second Widget $23.99 Second widget from the Widget Factory. Edit Delete 

3 Widget A2 245.00 Second generation widget. Edit Delete 

4 Widget Super 3 $999.00 A new third generation widget that’s new and improved Edit Delete 

a 


Ultimate Widget $1999.99 The ultimate in widgets--every person will want one of these. They're cool. Edit Delete 











图 8-2 ”添加 几 个 widget 之 后 Widget 显示 的 表格 信息 
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删除 对 象 的 链接 ( delete ) 实际 上 与 显示 对 象 的 链接 一 致 : /widgets/:id。 我 们 会 添加 
一 个 包含 一 个 删除 按钮 的 隐藏 的 表单 在 Show Widget 页 面 上 , 这 使 我 们 可 以 不 用 添 
加 新 的 路 由 而 完成 删除 功能 。 同 时 ， 这 也 提供 了 一 种 保护 ， 确 保 用 户 知道 他 们 删除 
的 是 哪个 widget。 


Wa 提示 
除了 在 Show Widget 页 面 上 完成 删除 请 求 之 外 ， 还 可 以 创建 一 个 新 的 
~ 路 由 ， 比 如 /widgets/:id/delete,， 并 在 删除 操作 发 生 时 生成 一 个 “Are you 


sure?” 的 确认 信息 。 


8.2.5 ”显示 单个 对 象 并 确认 对 和 象 的 删除 操作 


显示 单个 widget 和 为 属性 提供 占 位 一 样 简 单 ， 可 以 艇 入 在 任何 你 想 使 用 的 HTML 中 。 
在 widget 程序 中 ， 我 选择 ul (unordered list， 无 序列 表 ) 显示 widget 的 所 有 属性 。 


因为 我 们 在 页 面 中 包含 了 删除 对 象 的 功能 : 在 页 面 底 部 添加 一 个 表单 ,包含 一 个 显 
示 “Delete Widget” 的 按钮 。 表 单 中 隐藏 的 用 于 生成 HTML 删除 动作 的 _method 区 
域 可 以 匹配 程序 的 destroy Wik 整个 模板 如 示例 8-0 所 示 。 


示例 8-6 显示 widget 及 其 所 有 属性 的 页 面 和 用 于 删除 widget 的 表单 


<!doctype html> 

<html lang="en"> 

<head> 

<meta charset="utf-8"/> 

<title><%= title %></title> 

</head> 

<body> 

<hl><%= widget.name %></hl1> 

<ul> 

<li>ID: <%= widget.id %></li> 

<li>Name: <%= widget.name %></li> 

<li>Price: $<%= widget.price.toFixed(2) %></li> 
<li>Description: <%= widget.desc %></li> 

</ul> 

<form method="POST" action="/widgets/<%= widget.id %>" 
enctype="application/x-—www-form-urlencoded"> 


<input type="hidden" value="delete" name="_method"/> 
<input type="submit" name="submit" id="submit" value="Delete Widget"/> 


</form> 
</body> 


对 于 controller 代码 中 的 show 或 者 destroy 方法 基本 不 需要 修改 。destroy 方法 维持 原 
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状 ， 该 方法 所 有 功能 就 是 从 存储 中 删除 对 象 ， 并 发 送 消息 说 明 该 操作 结果 : 


exports.destroy = function (req, res) { 
var indx = req.params.id - 1; 
delete widgets [indx]; 


console.log('deleted ' + req.params.id) ; 


res.send('deleted ' + req.params.id); 
}; 


show 方法 没什么 修改 ， 只 是 简单 地 将 send 方法 替换 成 render, FA render 新 视图 来 
替换 发 送信 息 : 


// 显示 widget 


exports.show = function (req, res) { 
var indx = parselInt(req.params.id) - 1; 
if (!widgets [indx]) 
res.send('There is no widget with id of ' + req.params.id); 
else 


res.render('widgets/show', {title:'Show Widget',widget:widgets [indx]}); 
}; 


图 8-3 显示 了 Show Widget 页 面 的 样式 ， 页 面 底部 包含 Delete Widget 按钮 。 


w Widget: Second Widget a 


ini 


2 c © examples burningbird.n net:3 Wpwidgets/2 . 


‘Second Widget 


¢ ID 2 

@ Name: Second Widget 
+ Price: $23.99 

+ Description Second 





8-3 ” 带 有 删除 按钮 的 Show Widget DH 


到 现在 , 你 应 该 清楚 在 程序 中 使 用 视图 是 个 多 么 简单 的 事情 了 。 这 个 系统 最 好 的 地 
方 在 于 你 可 以 直接 对 视图 进行 修改 而 无 须 重 启程 序 : 视图 的 改变 会 Reena 一 次 
被 访问 时 生效 。 


最 后 一 个 视图 用 于 更 新 widget， 实 现 之 后 我 们 就 完成 了 在 widget 程序 中 使 用 EJS 
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8.2.6 ”提供 更 新 信息 的 表达 以 及 处 理 PUT 请 求 


用 于 编辑 widget 信息 的 表达 和 添加 新 widget 的 表达 基本 一 样 ， 除 了 添加 一 个 新 的 
区 域 :_method。 并 且 ， 表 单 中 存在 被 编辑 的 widget 的 数据 信息 ， 所 以 我 们 需要 将 
模板 标签 和 数据 对 应 起 来 。 


示例 8-7 包含 了 edit.ejs 模板 文件 的 内 容 。 注 意 一 下 input 元 素 中 模板 标签 与 值 域 的 
IEH, WA method 区 域 。 


示例 8-7 编辑 视图 模板 文件 ， 以 及 数据 显示 


<!doctype html> 

<html lang="en"> 

<head> 

<meta charset="utf-8"/> 

<title><%= title %></title> 

</head> 

<body> 

<hl>Edit <%= widget.name %></h1> 

<form method="POST" action="/widgets/<%= widget.id %>" 
enctype="application/x-www-form-urlencoded"> 


<p>Widget name: <input type="text" name="widgetname" 
id="widgetname" size="25" value="<%=widget.name %>" required/></p> 


<p>Widget Price: <input type="text" 

pattern="*\$?([0-9] {1,3}, ([0-9] {3},) * [0-9] {3} | [0-9] +) (. [0-9] [0-9] ) 29" 

name="widgetprice" id="widgetprice" size="25" value="<%= widget.price %>" 
required/></p> 

<p>Widget Description: <br/> 

<textarea name="widgetdesc" id="widgetdesc" cols="20" 

rows="5"><%= widget.desc %></textarea> 

<p> 


<input type="hidden" value="put" name="_method"/> 
<input type="submit" name="submit"™ id="submit" value="Submit"/> 


<input type="reset" name="reset" id="reset” value="Reset"/> 
</p> 


</form> 
</body> 


图 8-4 显示 了 编辑 页 面 。 你 需要 做 的 事情 就 是 修改 数值 ， 然 后 点 击 Submit 按钮 提 
交 修 改 。 


controller 代码 的 修改 与 之 前 的 一 样 简 单 。 用 res.render 访问 Edit 视图 ，widget fA 
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作为 数据 : 











: %& Widgets 


E = C © exampies.burningbird. net S000 moels/ ied w © yx 


Edit Second Widget 
I Widget name: Second Widget 
| Widget Price: :23 99 


| Widget Description: 


: Second 


| (Submit | { Reset ] 











8-4 Edit Widget 页 面 


// 显示 edit 表单 
exports.edit = function (req, res) { 

var indx = parselInt(req.params.id) - 1; 

res.render('widgets/edit', {title:'Edit Widget', widget:widgets[indx] }); 
F? 


处 理 update 过 程 的 代码 与 第 7 章 中 的 非常 类 似 ， 除 了 在 这 里 我 们 使 用 视图 替代 发 
送信 息 。 但 是 我 们 并 没有 创建 新 的 视图 ， 而 是 使 用 了 之 前 的 widgets/added.ejs 文件 。 
因为 两 个 操作 都 是 显示 对 象 所 有 属性 ， 并 且 接 收 title 作为 数据 ， 所 以 我 们 可 以 简单 
地 修改 title 来 重用 这 个 视图 : 


// 更 新 widget 
exports.update = function (req, res) { 
var indx = parselInt(req.params.id) - 1; 
widgets[indx] = 
{ id:indx + 1, 
name:req.body.widgetname, 
price:parseFloat (req. body.widgetprice), 
desc: req.body.widgetdesc} 
console.log(widgets[indx]); 
res.render ('widgets/added', {title: 'Widget Edited', widget:widgets [indx] }) 
}; 


并 且 ， 视 图 的 使 用 并 不 影响 显示 出 来 的 URL， 所 以 我 们 的 重用 并 不 会 造成 问题 。 
重用 可 以 在 程序 开发 过 程 中 节省 很 多 时 间 和 精力 。 
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在 我 们 切换 到 使 用 模板 的 过 程 中 你 已 经 看 到 controller 代码 的 不 同 片段 。 示 例 8-8 
是 文件 修改 后 的 全 部 内 容 ， 你 可 以 对 照 示 例 7-6 和 示例 7-7， 可 以 看 到 将 视图 融入 
代码 是 个 多 么 简单 的 事情 ， 以 及 视图 节省 了 我 们 多 少 不 必 要 的 工作 。 


示例 8-8 使 用 视图 的 widget controller 实现 
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var widgets = [ 


{ id:1, 
name:"The Great Widget", 
price:1000.00, 
desc:"A widget of great value" 
} 
] 
// /widgets/ 显示 widgets 索引 
exports.index = function (req, res) { 
res.render ('widgets/index', {title:'Widgets', widgets:widgets}) ; 
}; 
// 显示 新 的 widget 表单 
exports.new = function (req, res) { 
var filePath = require('path').normalize( dirname + "/../public/ 
widgets/new.html") ; 
res.sendfile(filePath) ; 
}; 


// 添加 widget 
exports.create = function (req, res) { 
// 生成 widget id 
var indx = widgets.length + 1; 
// 添加 widget 
widgets [widgets.length] = 
{ id:indx, 
name: req.body.widgetname, 
price:parseFloat (req.body.widgetprice), 
desc: req.body.widgetdesc }; 
// 输 出 到 控制 台 并 对 用 户 确 认 添 加 信息 
console.log(widgets[indx - 1]); 
res.render ('widgets/added', {title: 'Widget Added', widget:widgets[indx -1]}); 
}; 
// 显示 widget 
exports.show = function (req, res) { 
var indx = parselInt(req.params.id) - 1; 
if (!widgets [indx]) 
res.send('There is no widget with id of ' + req.params.id); 
else 
res.render ('widgets/show', {title:'Show Widget', widget :widgets[indx] }); 
be 
// 删除 widget 
exports.destroy = function (req, res) { 
var indx = req.params.id - 1; 
delete widgets[indx]; 
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console.log('deleted ' + req.params.id); 
res.send('deleted ' + req.params.id)j; 


}3 


// 显示 编辑 表单 
exports.edit = function (req, res) { 

var indx = parseInt(req.params.id) - 1; 

res.render('widgets/edit', {title:'Edit Widget', widget:widgets[indx] }); 
}; 


// 更 新 widget 信息 
exports.update = function (req, res) { 
var indx = parseInt(req.params.id) - 1; 
widgets[indx] = 
{ id:indx + 1; 
name:req.body.widgetname, 
price:parseFloat (req.body.widgetprice), 
desc: req.body.widgetdesc} 
console.log (widgets [indx]); 
res.render ('widgets/added', {title: 'Widget Edited', widget:widgets [indx] }) 
}; 


这 是 本 章 中 你 最 后 一 次 看 到 controller 的 代码 ， 因 为 我 们 即将 对 程序 做 出 重大 改变 : 
我 们 要 替换 掉 模 板 系统 。 


8.3 Jade 模板 系统 


Jade 是 由 Express 默认 安装 的 模板 系统 。 与 EIS 不 同 的 是 ，Jade 不 会 在 HTML 中 直 
接 佣 人 模板 标签 ， 而 是 使 用 简化 的 HTML. 


提示 
Jade 官网 : http://jade-lang.com/。 


Wa 
‘ 





8.3.1 Jade 语法 简介 


在 Jade 模板 系统 中 ，HTML WAW NERE GUATR, EKA ASAP. 
所 以 ， 对 于 以 下 代码 : 


<html> 
<head> 
<title>This is the title</title> 
</head> 
<body> 
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<p>Say hi World 
</body> 
</html> 


在 Jade 中 等 价 为 以 下 写法 : 


html 
head 
title This is it 
body 
p Say Hi to the world 


title Fl p 标签 的 内 容 都 跟 在 标签 名 之 后 。 没 有 结束 标签 符号 ， 也 是 由 缩 进 表示 。 以 
下 例子 使 用 了 class 和 id BREWIN AIRE: 


html 
head 
title This is it 
body 
div.content 
div#title 
p nested data 


该 模板 生成 的 HTML 代码 为 : 


<html> 

<head> 

<title>This is it</title> 
</head> 

<body> 

<div class="content"> 
<div id="title"> 
<p>nested data</p> 
</div> 

</div> 

</body> 

</html> 


如 果 某 个 标签 的 内 容 过 长 ， 比 如 一 个 段落 ， 可 以 使 用 竖 线 (| ) 来 拼接 内 容 : 
p 
| some text 


| more text 
| and even more 


对 应 的 HTML 为 : 
<p>some text more text and even more</p> 


另 一 种 做 法 是 使 用 句号 〈. )， 代 表 该 标签 区 域内 只 包含 文字 ， 可 以 省 略 竖 线 : 
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p. 
some text 
more text 
and even more 


还 可 以 引用 HTML 代码 作为 内 容 ， 在 生成 的 代码 中 也 会 被 当做 HTML 代码 处 理 : 


body. 
<hl>A header</hl> 
<p>A paragraph</p> 


form LRM ARZIR, Æ Jade 中 用 括号 表示 ,并 可 以 设置 属性 的 值 ( 如 果 有 )。 
属性 和 属性 之 间 只 需要 空格 分 离 ， 不 过 我 每 行 只 列 出 一 个 属性 以 增加 可 读 性 : 


以 下 是 Jade 模板 : 


html 
head 
title This is it 
body 
form (method="POST" 
action="/widgets" 
enctype="application/x-www-form-urlencoded") 
input (type="text" 
name="widgetname" 
id="widgetname" 
size="25") 
input (type="text" 
name="widgetprice" 
id="widgetprice" 
size="25") 
input (type="submit" 
name="submit" 
id="submit" 
value="Submit") 


生成 HTML 代码 : 


<html> 

<head> 

<title>This is it</title> 

</head> 

<body> 

<form method="POST" action="/widgets" 
enctype="application/x-—www-form-urlencoded"> 

<input type="text" name="widgetname" id="widgetname" size="25"/> 
<input type="text" name="widgetprice" id="widgetprice" size="25"/> 
<input type="submit" name="Submit" id="Submit" value="Submit"/> 
</form> 

</body> 

</html> 
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8.3.2 ”使 用 block 和 extends 模块 化 视图 模板 


现在 我 们 需要 修改 widget 程序 使 用 Jade 代替 EJS。 我 们 只 需要 修改 widget 程序 中 
的 app.js 文件 ， 修 改 模板 引擎 : 


app.set('view engine', ‘'jade'); 
application.None.Zip 不 需要 其 他 修改 。 


所 有 的 模板 共用 同一 个 页 面 布局 。 布局 很 简单 , 没有 侧 边 栏 页 脚 ,也 没有 使 用 任何 
CSS 样式 。 正 是 因为 布局 的 人 简单， 在 之 前 的 例子 中 我 们 并 没有 担心 在 每 个 view 中 
会 产生 重复 的 布局 代码 。 但 是 如 果 我 们 希望 添加 更 多 的 页 面 结 构 ， 比 如 侧 边栏 、 页 
首 、 页 尾 等， 那么 在 每 个 文件 中 维持 相同 的 布局 信息 就 变 得 很 麻烦 了 。 


所 以 第 一 件 我 们 需要 做 的 事情 就 是 创建 一 个 可 以 被 其 他 模板 使 用 的 布局 的 模板 。 


提示 

Express3.x 完全 改变 了 处 理 view 的 方式 ， 以 及 如 何 使 用 partial 和 
‘ layout。 本 章 中 使 用 Express2.x， 需 要 在 configure 方法 中 添加 以 下 代 
码 来 使 用 Jade 模板 : 


app.set('view options', {layout: false}); 


示例 8-9 是 完成 的 layout.jade 文件 ， 使 用 HTMLS 文件 类 型 ， 添 加 了 带 有 title 和 
meta 元 素 的 head 元 素 ， 加 入 了 body 元 素 ， 以 及 一 个 名 为 content 的 block. 


示例 8-9 Jade 中 简单 的 布局 模板 


doctype 5 
html (lang="en") 
head 
title #{title} 
meta (charset="utf-8") 
body 
block content 





注意 下 title PHS ALES (#f} ) 的 使 用 。 在 Jade 中 我 们 用 这 种 方式 将 数据 传递 
给 模板 。 这 种 标记 符 的 使 用 并 不 随 EJS 改变 ， 只 是 简单 的 语法 。 


在 每 个 content 模板 的 开始 加 入 以 下 代码 来 使 用 新 的 布局 模板 : 


extends layout 
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extends 告诉 模板 引擎 在 哪里 可 以 找到 页 面 需 要 的 布局 信息 , 而 block 则 告诉 模板 引 
擎 在 哪里 放置 生成 的 content 内 容 。 


你 不 必 使 用 content 作为 block 的 名 字 ， 还 可 以 使 用 多 个 block， 并 且 如 果 你 想 进 一 
步 分 解 布 局 ， 还 可 以 引用 其 他 模板 文件 。 我 修改 了 layout.jade 文件 ,包含 一 个 header， 
而 不 是 直接 在 layout 文件 中 使 用 head: 


doctype 5 
html (lang="en") 
include header 
body 
block content 


接 下 来 在 一 个 名 为 headerjade 的 文件 中 定义 header content, AZ UIF: 
head 


title #{title} 
meta (charset="utf-8") 


在 layout.jade 和 header.jade 文件 中 有 两 件 事 需 要 注意 下 。 
第 一 ，include 相对 路 径 。 如 果 把 views 分 解 为 以 下 目录 结构 : 


/views 
/widgets 
layout.jade 


/standard 
header.jade 


在 layout 文件 中 引用 header 模板 时 使 用 : 


include standard/header 


文件 类 型 并 不 一 定 要 是 Jade， 也 可 以 是 HTML。 当 引用 的 文件 不 为 Jade 文件 类 型 
时 ， 需 要 加 上 文件 扩展 名 : 


include standard/header.html 


第 二 , 在 header.jade 文件 中 不 要 使 用 缩 进 。 父 文件 中 已 经 带 有 缩 进 了 ， 引 用 的 模板 
文件 中 不 需要 重复 缩 进 。 事 实 上， 如 果 引 用 文件 中 带 有 缩 进 ， 生 成 代码 时 会 报错 。 


xx， ”提示 
现在 你 也 许 会 考虑 将 静态 的 Add Widget 文件 转换 为 动态 的 ,以 使 用 新 
3 ， 的 布局 模板 的 特性 . 
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8.3.3 Widget View 转换 为 Jade 模板 


第 一 个 需要 从 EJS 转换 为 Jade 的 是 added.ejs 模板 文件 ， 该 文件 提供 了 成 功 添加 一 
个 widget 之 后 的 反馈 信息 。 新 的 模板 文件 命名 为 added.jade ( 扩展 名 不 同 但 是 名 字 
必须 相同 ， 才 能 继续 使 用 现 有 的 controller 代码 )， 使 用 新 定义 的 lauout.jade 文件 ， 
如 示例 8-10 所 示 。 


示例 8-10 “添加 Widget” 页 面 转 换 为 Jade 


extends layout 
block content 
hl #{titile} | #{widget.name} 
ul 
li id:#{widget.id} 
li Name:#{widget.name} 
li Price:$#{widget.price.toFixed()} 
li Desc:#{widget.desc} 


注意 ， 我 们 依然 可 以 使 用 toFixed 方法 对 price 输出 格式 化 。 


Block 名 为 content, 与 layout.jade 文件 设置 的 block 名 相同 。 简 化 的 HTML 代码 hl 
和 ul 标签 对 应 从 controller 获取 的 数据 ， 本 例 中 ， 数 据 为 widget 对 象 的 信息 。 


运行 widget 程序 并 添加 一 个 新 的 widget， 生 成 与 EJS 同样 的 HTML 代码 : 一 个 
header。 新 添加 的 widget 属性 列表 controller 代 公 完全 不 需要 修改 。 


转换 widget 最 主要 的 显示 页 面 

下 一 个 需要 转换 的 是 index 模板 ， 在 表 中 显示 所 有 widgets， 市 有 修改 和 删除 选项 。 
在 这 次 转换 中 我 们 会 尝试 些 与 之 前 不 一 样 的 东西 。 我 们 会 从 生成 整 张 表 转 为 单独 生 
成 每 个 widget 的 表 项 。 


首先 , 我 们 创建 一 个 名 为 rowjade 的 模板 。 假 定数 据 是 一 个 名 为 widget 的 对 象 ， 可 
以 访问 该 对 象 的 以 下 属性 : 


ET 
td #{widget.id} 
td #{widget.name} 
td $#{widget.price.toFixed(2) } 
td #{widget.desc} 





a(href=' /widgets/#{widget.id}/edit') Edit 
td 
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a(href='/widgets/#{widget.id}') Delete 
BE— FT AR AH MAT, APPA AERA ERR 


index.jade 文件 使 用 新 创 的 row 模板 代码 如 示例 8-11 所 示 。 该 模板 介绍 了 两 个 新 的 
Jade 构造 器 : AFFINA (iteration )。 条 件 语句 用 于 测试 widgets 对 象 的 长 
度 ， 以 确保 待 处 理 的 对 象 是 一 个 非 空 数组 。 和 迭代 需 使 用 简化 的 Array.forEach 方法 ， 
遍历 数组 ， 并 将 每 个 实例 赋值 给 新 的 对 象 widget。 


示例 8-11 BIE widgets 表格 的 index 模板 


extends layout 


block content 
table 
caption Widgets 

if widgets.length 

tr 
th -ID 
th Name 
th Price 
th Description 


each widget in widgets 
include row 


这 种 写法 比 HTML 手动 加 入 全 部 的 加 括号 省 事 很 多 , 特别 是 类 似 于 table th 标签 这 
种 。Jade 模板 的 结果 与 EJS 模板 结果 相同 : HTML table， 每 行 显示 widget， 可 以 删 
除 或 者 修改 每 个 widget。 


8.3.4 转换 edit 和 delete 表单 
下 面 需要 做 的 两 件 事情 是 对 表单 进行 修改 。 


首先 ， 我 们 用 Jade 来 实现 edit 模板 。 这 部 分 唯一 有 趣 的 地 方 是 处 理 多 种 属性 。 可 
以 用 空格 分 隔 不 同属 性 , 但 是 我 觉得 每 行 单独 显示 一 个 属性 更 容易 阅读 。 这 种 方法 
你 可 以 很 容易 检查 是 否 列 出 了 全 部 的 属性 以 及 值 是 否 正确 。 示例 8-12 中 代码 较 长 ， 
是 Edit Widget 表单 的 全 部 代码 。 


示例 8-12 Edit Widget 表单 Jade 模板 


extends layout 


block content 
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hl Edit #{widget.name} 
form (method="POST" 
action="/widgets/#{widget.id}" 
enctype="application/x-www-form-urlencoded") 
p Widget Name: 
input (type="text" 
name="widgetname" 
id="widgetname" 
size="25" 
value="#{widget.name}" 
required) 
p Widget Price: 
input (type="text" 
name="widgetprice" 
id="widgetprice" 
size="25" 
value="#{widget.price}" 
patterne"=""\S? (10-91 {173}, CL0-9]1{3),)* (0-9) (3) | TO=] F) 
C(O) [09T] Ten 
required) 
p Widget Description: 
br 
textarea (name="widgetdesc" 
id="widgetdesc" 
cols="20" 
rows="5") #{widget.desc} 
p 
input (type="hidden" 
name="_method" 
id="_ method" 
value="put") 
input (type="submit" 
name="submit" 
id="submit" 
value="Submit") 
input (type="reset" 
name="reset" 
id="reset" 
value="reset") 


在 转换 Show Widget 页 面 过 程 中 ， 我 注意 到 页 面 顶部 的 信息 与 示例 8-10 中 
added.jade 模板 中 一 致 ， 都 是 所 有 widgets 属性 的 无 序列 表 。 又 可 以 进行 一 次 简化 ! 


我 创建 了 一 个 新 的 模板 一 一 widget.jade ， 只 用 于 显示 widget 属性 的 列表 : 


ul 
li id: #{widget.id} 
li Name: #{widget.name} 
li Price: #{widget.price.toFixed (2) } 
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li Desc: #{widget.desc} 


接 下 来 ， 修 改 示例 8-10 中 的 added.jade 文件 ， 使 用 新 建 的 模板 : 
extends layout 


block content 
hl #{title} | #{widget.name} 
include widget 


新 的 Show Widget 模板 也 可 以 使 用 widget. jade 文件 ， 如 示例 8-13 所 示 。 
示例 8-13 新 Show Wdget NM Jade 模板 


extends layout 


block content 
hl #{widget.name} 
include widget 
form (method="POST" 
action="/widget/#{widget.id}" 
enctype="application/x-—www-form-urlencoded") 
input (type="hidden" 
name=" method" 
id=" _method" 
value="delete") 
input (type="submit" 
name="submit" 
id="submit" 
value="Delete Widget") 


可 以 看 到 模块 化 使 每 个 模板 都 变 得 更 简单 易 恋 ， 容 易 维护 了 。 


我 们 现在 可 以 通过 新 的 模块 化 模板 显示 和 删除 特定 的 widget， 这 样 就 会 产生 疑问 : 
Jade 模板 与 EJS 模板 区 别 在 哪里 ? 


在 widget 程序 中 ， 当 删除 某 个 widget 时 ，widget 被 “ 原 地 ”删除 。 这 意味 着 array 
元 素 被 设置 为 null， 所 以 widget 在 数组 中 的 位 置 与 widget id 有 关 。 这 种 方法 在 使 
用 EJS 添加 、 删 除 和 显示 widget 的 时 候 不 会 引起 问题 ， 但 是 在 Jade 中 会 产生 问题 : 
会 产生 缺失 属性 的 错误 。 因 为 Jade 中 并 不 像 EJS 模板 处 理 一 样 过 滤 掉 值 为 null 的 
array 元 素 。 


不 过 这 一 问题 很 容易 解决 。 如 示例 8-11 所 示 ， 只 需要 在 index.jade 文件 中 添加 一 个 
条 件 判 断 ， 确 保 widget 对 象 存在 〈 不 为 空 ) 即 可 : 


extends layout 


block content 
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table 
caption Widgets 
if widgets.length 
七 工 

th ID 
th Name 
th Price 
th Description 


each widget in widgets 
if widget 
include row 


截至 现在 ， 所 有 的 模板 view 都 被 转换 为 Jade 实现 ， 应 用 程序 的 功能 也 全 部 实现 。 
(除了 第 10 章 中 我 们 会 添加 数据 部 分 ) 


虽然 程序 完成 了 , 但 是 对 用 户 来 说 并 没有 太 大 吸引 力 。 当 然 , 我 们 可 以 很 容易 地 在 
header 中 添加 样式 文件 来 修饰 所 有 显示 的 元 素 , 但 是 我 们 选择 另 一 种 实现 方式 : 使 
用 Stylus。 


8.4 使 用 Stylus 完成 简单 的 CSS 样式 


很 容易 在 模板 文件 中 添加 样式 。 在 Jade 模板 文件 中 ， 我 们 给 headerjade 文件 添加 
样式 : 
head 
title #{title} 
meta (charset="utf-8") 
link (type="text/css" 
rel="stylesheet" 


href="/stylesheets/main.css" 
media="all") 


这 里 定义 的 样式 会 对 程序 中 所 有 的 view 起 作用 , 因为 所 有 view 都 是 用 了 layout 模 
板 ， 而 layout 模板 引用 了 该 header 文件 。 


ws ”提示 
现在 你 肯定 发 现 了 将 静态 newhtml 文件 转换 为 模板 view 的 价值 所 在 : 
s 对 header 文件 的 修改 并 不 会 影响 静态 文件 ， 你 需要 手动 编辑 。 


如 果 你 已 经 开始 喜欢 上 了 Jade 的 语法 ， 你 可 以 在 程序 中 使 用 Stylus， 用 该 语法 描 
述 CSS. 
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ACE Stylus: 
npm install stylus 


Stylus 与 Jade 模板 系统 不 同 ， 它 并 不 会 创建 动态 的 CSS views. Stylus 所 做 的 是 在 
第 一 次 访问 模板 或 者 每 次 模板 被 修改 时 根据 Stylus 模板 生成 静态 样式 文件 。 


Wa 提示 
ry 更 多 关于 Stylus: http://learnboost.github.com/stylus/docs/js.html, 


` 
SA 


想 在 程序 中 使 用 Stylus， 需 要 在 主 文件 (app.js ) 的 require 部 分 引用 该 module, $ 
后 需要 像 其 他 中 间 件 一 样 在 configure 方法 调用 中 引入 Stylus 中 间 件 ， 传 人 Stylus 
模板 的 选项 参数 以 及 设置 编译 好 的 样式 文件 的 目的 路 径 。 示 例 8-14 显示 了 修改 后 


的 app.js 文件 ， 修 改 用 粗 体 标 出 。 
示例 8-14 在 widget 程序 中 加 入 CSS 模板 支持 


var express = require('express') 
routes = require('./routes') 
map = require('./maproutecontroller') 


http = require('http') 
stylus = require('stylus') 
app = express(); 


= ~ ` ` `~ 


app.configure (function () { 
app.set('views', _ dirname + '/views'); 
app.set('view engine', 'jade'); 
app.use(express.favicon()); 
app.use(express.logger('dev')); 
app.use(express.staticCache({maxObjects:100, maxLength:512})); 
app .use (stylus .middleware ( { 
src: dirname + '/views' 
,dest: dirname + '/public' 

} ) ) ; 
app.use(express.static( dirname + '/public')); 
app.use(express.bodyParser()); 
app.use(express.methodOverride()); 
app.use(app.router); 
app.use(express.directory( dirname + '/public')); 
app.use(function (req, res, next) { 

throw new Error(req.url + ' not found'); 
}); 
app.use(function (err, req, res, next) { 

console.log(err); 

res.send(err.message) ; 
} ) ; 

Pia 


app.configure('development', function () { 
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app.use(express.errorHandler()); 


} ) ; 
app.get('/', routes.index) ; 
var prefixes = ['widgets']; 


// map route to controller 

prefixes.forEach(function(prefix) { 
map.mapRoute (app, prefix); 

}); 

http.createServer (app) .listen(3000); 


console.log("Express server listening on port 3000"); 


做 完 以 上 修改 后 当 你 第 一 次 访问 widget 程序 时 ,你 可 能 会 注意 到 一 个 短暂 的 停顿 。 
原因 在 于 Stylus 模块 正在 生成 样式 文件 。 这 个 过 程 发 生 在 新 添加 或 者 修改 一 个 样式 
模板 后 重启 程序 的 时 候 。 在 样式 文件 生成 后 ,提供 样式 的 实际 是 生成 的 文件 ， 并 不 
会 在 访问 每 个 页 面 时 重新 编译 。 


提示 
如 果 对 样式 模板 进行 修改 ， 需 要 重启 Express 程序 。 





Stylus 样式 模板 扩展 名 为 .styl。 源 目录 设置 为 views, 但 是 样式 模板 期 望 的 路 径 是 在 
views 目录 下 有 一 个 名 为 stylesheets 的 子 目 录 。 当 成 生 静 态 样 式 文件 时 ， 会 被 放 在 
目标 目录 下 的 stylesheets 子 目 录 中 (本 例 中 为 /public )。 


在 习惯 了 Jade 之 后 ,你 会 发 现 Stylus 的 语法 非常 熟悉 。 每 个 需要 添加 样式 的 元 素 都 被 
列 出 ， 缩 进 表 示 该 元 素 的 样式 属性 。 这 种 语法 省 略 了 花 括 号 ， 逗 号 以 及 分 号 的 使 用 。 


例如 ， 设 置 网 页 的 背景 色 为 黄色 ， 字 体 颜 色 会 红色 ，Stylus 模板 如 下 : 


body 
background-color yellow 
color red 


如 果 几 个 元 素 需 要 共享 蘑 些 样式 , REMIT Saha, x45 CSS 一 致 : 


p, tr 
background-color yellow 
color red 


或 者 可 以 用 统一 缩 进 写 在 不 同行 : 
P 
七 工 
background-color yellow 
color red 
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如 果 你 需要 使 用 悬 停 伪 类 ， 比 如 :hover:visited， 语 法 如 下 : 


textarea 
input 
background-color #fff 
&: hover 
background-color cyan 


FPS (& ) ANE. GRADE, AF Stylus 模板 : 


p, tr 
background-color yellow 
color red 


textarea 
input 
background-color #fff 
&:hover 
background-color cyan 


生成 的 CSS 文件 为 : 


ps 
Er { 
background-color: #ff0; 
color: #£00; 
} 
textarea, 
input { 
background-color: #fff; 
} 
textarea:hover, 
input:hover { 
background-color: $0ff; 
} 


关于 Stylus 还 有 很 多 内 容 ， 我 把 这 些 留 给 你 们 作为 课外 练习 。Stylus 官网 提供 了 很 
详细 的 Stylus 语法 的 文档 。 在 这 章 结束 之 前 ， 我 们 创建 了 Stylus 样式 表 来 优化 widget 


程序 的 展示 。 


另外 , 我 们 需要 给 index 列表 页 面 的 HTMLtable 元 素 添 加 border 和 空间 。 还 需要 修 
改 header 的 字体 ， 删 除 列 表 前 面 的 圆 点 标识 符 。 这 些 都 是 很 小 的 修改 ， 但 是 会 让 


widget 程序 有 一 个 全 新 的 展示 。 


示例 8-15 显示 了 新 的 样式 模板 。 文 件 并 不 大 也 没 没有 任何 复杂 的 CSS。 使 用 了 最 


基本 的 东西 ， 但 某 种 程度 上 改善 了 程序 的 外 观 。 
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示例 8-15 widget 程序 的 Stylus 模板 


body 
margin 50px 
table 
width 90% 
border-collapse collapse 
table, td,th, caption 
border lpx solid black 
td 
padding 20px 
caption 
font-size larger 
background-color yellow 
padding 10px 
hl 
font 1.5em Georgia, serif 
ul 
list-style-type none 
form 
margin 20px 
padding 20px 


图 8-5 显示 了 添加 几 个 widget 之 后 的 index 页 面 。 新 的 样式 并 不 太 精 致 ， 但 是 数据 
内 容 比 之 前 更 容易 阅读 和 查找 。 
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结构 化 数据 、Node 和 Redis 


当 谈 到 数据 时 ， 我 们 会 想到 关系 型 数据 库 以 及 其 他 一 些 被 称 为 NoSQL 的 数据 库 。 
在 NoSQL 分 类 中 ， 有 一 种 基于 键 值 对 (key/value pairs) 的 结构 化 数据 类 型 ， 它 通 
第 被 存储 在 内 存 以 支持 快速 访问 。 三 种 最 流行 的 基于 内 存 键 值 对 的 存储 系统 是 
Memcached, Cassandra 和 Redis。Node 开发 人 员 应 该 值得 高 兴 ， 因 为 Node 对 这 三 
种 存储 系统 都 提供 支持 。 


Memcached 主要 被 用 来 缓存 数据 请 求 , 以 便 快速 存 取 在 内 存 中 缓存 的 数据 。 它 对 分 
布 式 计算 的 支持 也 很 好 , 但 是 对 于 复杂 数据 类 型 的 文 持 却 比较 有 限 。 所 以 ， 对 于 需 
要 做 很 多 查询 的 应 用 程序 来 说 Memcached 非常 好 用 ， 而 对 于 需要 进行 大 量 数据 读 
写 操 作 的 应 用 程序 来 说 却 不 是 很 合适 。 但 是 Redis 能 够 文 持 后 一 种 应 用 程序 ， 因 为 
它 有 着 里 越 的 数据 存储 文 持 。 此 外 , Redis 支持 持久 性 存储 , 能 够 提供 比 Memcached 
更 好 的 灵活 性 ， 文 持 更 多 数据 类 型 。 然 而 , 不同 于 Memcached 的 是 ，Redis 只 能 工 
作 在 一 人 台 机 需 上 。 


Redis 和 Cassandra 的 比较 结果 与 上 面 类 似 。 与 Memcached 一 样 Cassandra 支持 集 
RF, 而 且 同 样 对 数据 结构 的 支持 比较 有 限 。 它 对 ad hoc 查询 支持 的 非常 好 ， 而 Redis 
则 不 适合 这 种 查询 方式 。 不 过 Redis fal HAA, 不 复杂 , 一 般 情 况 下 也 比 Cassandra 
有 更 好 的 效率 。 由 于 这 些 以 及 其 他 一 些 原 因 ，Redis 已 经 获得 了 非常 多 的 Node FF 
发 者 的 支持 , 这 就 是 为 什么 我 在 本 章 中 选择 使 用 它 讲 解 有 关键 值 对 存储 的 原因 ， 而 
非 Memcached 或 Cassandra。 


在 前 几 章 中 , 我 们 使 用 了 类 似 于 教程 式 的 风格 来 讲解 和 说 明 相 关 技 术 , 本 章 中 我 将 
稍 作 改 变 ， 通过 三 个 包含 有 具体 功能 的 实例 来 说 明 有 关 Node 和 Redis 的 相关 技术 : 


。 ”建立 一 个 游戏 排行 榜 
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。 创建 一 个 消息 队列 
。 跟踪 网 页 统计 


这 些 应 用 程序 还 会 使 用 前 几 个 章 中 提 到 的 模块 和 技术 ， 如 Jade 模板 系统 (在 第 8 
章 )，Async 模块 〈 在 第 5 章 )，Express 框架 (在 第 7 和 第 8 章 )。 

TEE 扣 示 
Redis 的 网 址 http://redis.io/, 更 多 有 关 Memcached 的 信息 http://memcached.org/, 
以 及 Apache Cassandra 的 网 址 http://cassandra.apache.org/. 





9.1 Node 和 Redis 


支持 Redis 的 模块 有 很 多 ， 例 如 Redback， 它 提供 了 一 个 高 抽象 层次 的 接口 。 但 在 
本 章 中 ,我 们 将 关注 男 一 个 由 Matt Ranney 编写 的 node redis 模块 ( 之 后 我 会 使 用 “redis” 
表示 该 模块 )。 KEM redis 是 因为 它 提供 了 一 个 简单 而 优雅 的 接口 来 直接 执行 Redis 
命令 , 这样 你 就 可 以 充分 利用 上 自己 对 数据 的 了 解 并 在 给 予 系统 最 小 干预 的 情况 下 来 
操作 存储 系统 了 。 

入 提示 
redis 的 GitHub A & Æ https://github.com/mranney/node_redis. 





a 
使 用 npm 安装 redis 模块 : 
npm install redis 


我 同样 也 建议 使 用 hiredis E, 因为 它 是 非 阻 塞 的 且 能 提高 性 能 。 使 用 下 面 的 命令 安装 它 : 


npm install hiredis redis 


想 要 在 Node 应 用 程序 中 使 用 redis 的 话 ， 首 先 要 包含 模块 : 


var redis = require('redis'); 


然后 ， 使 用 createClient 方法 创建 一 个 Redis 客户 端 : 


var client = redis.createClient(); 


createClient 方法 包含 三 个 可 选 参数 : port，host 和 options. host 默认 值 为 12 7.0.0.1, port 
默认 值 为 6379。port 的 默认 值 也 是 Redis 服务 器 默认 使 用 的 端口 号 , 所 以 如 果 Redis 
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服务 器 与 Node 应 用 程序 都 托管 在 同一 台 机 器 上 的 话 ， 就 无 需 修改 这 些 默认 值 了 。 
第 三 个 参数 是 一 个 对 象 ， 它 所 支持 的 选项 如 下 : 
parser 
Redis 协议 replay 解析 器 ， 默 认为 hiredis。 也 可 以 使 用 javascript。 
return_buffers 
上 默认 为 false。 如 果 为 te， 所 有 的 回复 将 以 Node buffer 对 象 返回 ， 而 不 是 字符 串 。 


detect_buffers 


SUDA false. A true 并 且 有 原始 操作 命令 被 缓存 起 来 时 ， 回 复 信 息 将 被 包 
装 在 Node buffer 对 象 中 。 


socket_nodelay 
默认 为 ttue， 指 定 是 否 在 TCP 流 中 调用 setNoDelay. 
no_ready_check 


默认 为 false. WEA true 时 ， 会 阻止 “ready check” 被 发 送 到 服务 器 ， 以 便 准 
备 更 多 的 命令 。 


在 你 更 熟悉 Node 和 Redis 前 ， 最 好 使 用 默认 设置 。 


一 旦 建立 了 客户 端 与 Redis 数据 存储 系统 的 连接 , 你 就 可 以 发 送 命令 给 服务 器 直到 
调用 client.quit 方法 关闭 该 连接 。 如 果 想 强制 关闭 连接 ， 你 可 以 调用 client.end 方法 ， 
该 方法 不 会 等 竺 答复 解析 完毕 。 如 果 你 的 应 用 程序 被 卡 住 ， 或 者 你 想 重 新 开始 ， 
client.end 方法 是 一 个 好 的 选择 。 


通过 客户 端 连接 发 出 Redis 命令 是 一 个 相当 直观 的 过 程 , 所 有 的 命令 都 暴露 在 客户 
对 象 的 各 个 方法 中 ， 命 令 所 需 的 参数 则 作为 方法 参数 传递 。 同 样 遵 循 Node 程序 开 
发 的 特点 , 这 些 方法 的 最 后 一 个 参数 都 是 回调 末 数 , 用 于 接收 并 处 理 返回 的 错误 信 
息 或 任何 对 应 于 Redi 命令 的 数据 或 答复 。 

在 下 面 的 代码 中 ， 我 们 使 用 client.hset 方法 设置 哈 希 属性 : 


client.hset("hashid", "propname", "propvalue", function(err, reply) { 
// do something with error or reply 


}) 3? 
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hset 命令 可 设置 一 个 值 ， 因 此 没有 返回 数据 ， 只 返回 Redis 的 确认 信息 。 如 果 你 调 
用 了 一 个 可 以 返回 多 个 值 的 方法 , 例如 client.hvals, 那么 在 回调 函数 的 第 二 个 参数 
中 将 会 保存 字符 串 数组 或 者 是 对 象 数 组 : 
client.hvals(obj.member, function (err, replies) { 
if (err) { 


return console.error("error response - " + err); 


} 


console.log(replies.length + " replies:"); 
replies.forEach(function (reply, i) { 
console.log(" "+ i + ": "+ reply); 
} ) ; 
Fig 


因为 Node 回调 无 所 不 在 ， 但 很 多 Redis 命令 的 返回 信息 中 仅 包 含 了 类 似 于 操作 成 
功 的 确认 回复 。 因 此 ，redis 模块 提供 了 redis.print 方法 ， 你 可 以 将 其 作为 回调 因数 
的 最 后 一 个 参数 传人 : 


client.set("somekey", "somevalue", redis.print); 
redis.print 方法 会 将 错误 信息 或 答复 内 容 输出 到 控制 台 并 返回 。 


现在 ， 你 是 否 已 经 迫不及待 的 想 要 知道 redis 模块 是 如 何 应 用 的 了 吧 ? 接 下 来 我 们 
就 开始 在 实际 的 应 用 程序 中 使 用 它 吧 。 


9.2 构建 游戏 得 分 排行 榜 


我 们 可 以 用 Redis 创建 一 个 游戏 排行 榜 。 排 行 榜 通 常用 来 记录 电子 游戏 的 得 分 ， 包 
括 家 用 电脑 游戏 、 智 能 手机 游戏 ， 以 及 平板 电脑 游戏 。OpenFeint 就 是 被 广泛 使 用 
的 一 个 排行 榜 , 它 允 许 游 戏 玩家 在 线 创 建 个 人 档案 并 记录 各 种 游戏 的 得 分 。 这 样 玩 
家 就 可 以 与 朋友 竞争 ， 还 可 以 尝试 挑战 任何 游戏 的 最 高 得 分 。 


这 是 一 个 可 以 混合 使 用 多 种 数据 存储 系统 来 实现 的 应 用 程序 。 玩 家 的 个 人 档案 可 以 
保存 在 一 个 关系 型 数据 存储 系统 中 ， 而 他 们 的 游戏 得 分 则 可 以 保存 在 Redis 存储 系 
统 中 。 分 数 信 息 的 数据 需求 很 简单 , 但 会 被 大 量 的 用 户 频 繁 地 访问 和 修改 。 据 一 个 
Facebook 游戏 开发 人 员 估 计 , 在 游戏 高 峰 时 间 , 大 约 有 10000 个 并 发 用 户 以 每 分 钟 
200000 次 请 求 的 速度 访问 排行 榜 。 然 而 ， 想 要 让 系统 处 理 这 些 请 求 其 实 并 不 困难 ， 
因为 数据 不 复杂 , 也 没有 必要 使 用 事务 。 坦 率 地 说 ， 如 果 使 用 关系 或 文档 数据 库 来 
处 理 这 种 需求 就 太 过 于 杀 鸡 用 牛刀 了 , 而 比较 理想 的 选择 则 是 使 用 像 Redis 一 类 的 
键 值 对 数据 存储 系统 。 
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对 于 这 个 应 用 程序 ，Redis 的 hash 和 sorted set 是 最 适用 的 数据 结构 。 选 择 hash 是 
因为 每 条 分 数 信息 只 需要 不 多 的 域 就 可 以 描述 。 通 常情 况 下 ， 你 会 存储 一 个 成 员 
ID, 也 许 还 包括 玩家 的 名 字 ( 为 了 不 必 频 繁 地 查询 或 保存 到 关系 或 文档 型 数据 库 )， 
可 能 还 要 包含 游戏 名 称 〈( 如 果 系 统 提供 多 个 游戏 的 排行 榜 )， 以 及 最 后 一 次 游戏 的 
时 间 ， 当 然 还 有 游戏 得 分 ， 以 及 任何 其 他 相关 信息 。 


而 选择 sorted set 数据 结构 来 追踪 分 数 及 用 户 名 是 因为 通过 它 能 够 快速 地 访问 前 10 
个 或 者 前 100 个 最 高 游戏 得 分 信息 。 


为 了 创建 一 个 可 以 更 新 Redis 数据 库 的 应 用 程序 ,我 修改 了 第 3 章 中 的 TCP 客户 端 
及 服务 闪 应 用 程序 。 客 户 端 会 发 送 数据 给 服务 端 ， 服 务 端 则 会 更 新 Redis。 对 于 一 
个 游戏 应 用 程序 来 说 ， 比 起 使 用 HTTP 或 其 他 方式 ， 使 用 TCP 套 接 字 来 保存 数据 
到 服务 器 是 非常 常见 的 。 


TCP 客户 问 会 将 我 们 在 命令 行 中 输入 的 信息 发 送 给 服务 端 ,因此 我 们 完全 采用 了 示 
例 3-3 的 代码 ， 在 此 不 再 重复 说 明 。 但 是 与 之 前 测试 不 同 的 是 ， 当 客户 端 运行 后 ， 
我 们 需要 输入 一 些 文本 信息 。 在 本 例 中 ， 我 输入 了 一 段 ISON 文本 ,描述 了 需要 
Redis 数据 库 进行 排序 处 理 的 分 数 信 息 。 如 下 所 示 : 


{"member™ : 400, "first_name" : "Ada", "last_name" : "Lovelace", "score": 
§3455; "date" : "1071071840" 


接着 , 我 们 修改 了 服务 端 应 用 程序 , 以 便 它 能 将 接收 到 的 文本 信息 转换 为 JavaScript 
WA, ， 并 能 将 每 个 成 员 信息 保存 到 hash 表 中 ， 成 员 编 号 以 及 分 数 也 会 被 添加 到 
sorted set， 并 以 游戏 得 分 做 排序 。 示 例 9-1 显示 了 修改 后 的 TCP 服务 器 应 用 程序 。 


示例 9-1 可 以 更 新 Redis 数据 存储 的 TCP 服务 端 程序 


var net = require('net’); 
var redis = require('redis'); 


var server = net.createServer(function(conn) { 
console. log( ‘connected’ ); 


// create Redis client 
var client = redis.createClient(); 


client.on('error', function(err) { 
console.log('Error ' + err); 


// fifth database is game score database 
client.select(5); 
conn.on('data', function(data) { 
console.log(data + ' from ' + conn.remoteAddress + ' ' + 
conn. remotePort) ; 
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try { 
var obj = JSON.parse(data); 


// add or overwrite score 

client.hset(obj.member, "first_name", obj.first name, redis.print); 
client.hset(obj.member, "last_name", obj.last_name, redis.print); 
client.hset(obj.member, "score", obj.score, redis.print); 
client.hset(obj.member, "date", obj.date, redis.print); 


// add to scores for Zowie! 

client.zadd("Zowie!", parseInt(obj.score), obj.member) ; 
} catcn(err) { 

console. log(err) ; 


> 
conn.on('close', function() { 
console.log('client closed connection’ ); 
client.quit(); 


}).listen(8124) ; 


console. log('listening on port 8124'); 
当 服 务 端 被 创建 时 ， 与 Redis 的 连接 也 被 建立 起 来 ; 当 服务 端 关 闭 时 ， 与 Redis 的 
连接 会 被 断 开 。 男 一 种 方法 是 创建 一 个 静态 的 客户 端 连接 ,在 当前 访问 请 求 完 成 前 ， 
这 个 连接 一 直 存 在 ,但 是 这 种 方法 也 存在 弊端 。 关 于 什么 时 候 创 建 Redis 客户 端的 
问题 ， 可 以 参见 本 章 后 面 的 “ 何 时 创建 Redis 客户 端 ? ”部 分 。Redis 的 数据 对 象 
转换 以 及 数据 保存 代码 被 包含 在 异常 处 理 代码 块 中 ， 这 样 便 能 捕获 任何 由 于 无 效 或 
错误 输入 而 引起 的 服务 程序 异常 中 止 时 产生 的 错误 信息 。 


如 上 所 述 , 我 们 的 应 用 程序 会 更 新 两 个 不 同 的 数据 存储 : 一 个 是 用 于 保存 每 个 玩家 
得 分 信息 ( 包 插 名称、 得 分 和 日 期 ) 的 hash， 另 一 个 sorted set 则 被 用 于 保存 按照 
得 分 排序 的 成 员 ID 信息 。 成 员 ID 被 用 来 作为 hash 的 key， 而 在 sorted set 中 游戏 
得 分 被 用 来 作为 成 员 ID 的 排序 依据 。 所 以 ， 让 程序 能 正常 工作 的 关键 就 是 在 两 个 
数据 存储 中 均 出 现 的 成 员 ID. 


FE PH, 应 用 程序 需要 显示 Zowie 游戏 前 五 名 得 分 者 的 信息 (该 游戏 以 及 分 数 信息 
是 为 了 测试 而 虚构 的 )。 在 sorted set 中 ,你 可 以 通过 Redis 提供 的 zrange 命令 得 到 
一 组 按照 得 分 排序 的 数据 。 然 而 , 这 个 函数 返回 的 数据 是 按照 游戏 得 分 从 低 到 高 的 
顺序 排列 的 ， 这 与 我 们 想 要 的 得 分 数据 的 顺序 恰好 相反 。 所 以 ,这 里 需要 使 用 Redis 


提供 的 男 一 个 命令 zrevrange。 


为 了 显示 得 分 前 五 名 的 游戏 玩家 ， 我 们 将 会 创建 一 个 HTTP 服务 端 ， 并 将 查询 结果 作 
为 一 个 简单 列表 返回 。 为 了 得 到 一 个 相对 体面 的 显示 结果 , 我 们 打算 使 用 Jade 模板 系 
统 ， 但 由 于 当前 的 应 用 程序 并 不 是 基于 Express 框架 的 ， 所 以 只 能 直接 使 用 Jade。 
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当 需 要 在 Express 以 外 使 用 Jade 时 ， 首 先 需 要 读 取 模板 文件 的 内 容 ， 然 后 调用 
compile 方法 并 传人 文件 内 容 和 一 些 可 选项 。 在 本 例 中 , 我 只 使 用 了 filename 选项 ， 
这 是 因为 我 在 模板 文件 中 使 用 了 include 指令 ， 该 指令 需要 使 用 filename 选项 。 实 
际 上 ， 我 需要 的 是 模板 的 文件 名 及 路 径 信 息 ， 这 样 就 可 以 在 Jade 模板 中 包含 并 使 
用 与 模板 同 路 径 的 其 他 文件 了 。 


示例 9-2 展示 了 程序 所 使 用 的 Jade 模板 。 请 注意 其 中 的 include 指令 ， 它 能 直接 在 
SPE HKA CSS 人 代码。 因此， 我 就 没有 再 在 应 用 程序 中 实现 静态 文件 服务 来 响应 
浏览 硕 对 CSS 文件 的 请 求 了 。 请 注意 我 们 在 样式 标签 style 的 开始 和 关闭 处 还 使 用 
了 管道 符 (| ), 它 表示 这 个 style 标签 是 HTML 语法 而 非 Jade 语法 ,以 便 Jade 能 正 
常 处 理 style 标签 中 通过 include 指令 包含 的 文件 。 


示例 9-2 用 于 显示 五 个 最 高 得 分 的 Jade 模板 文件 


doctype 5 
html(lang="en") 
head 

title Zowie! Top Scores 
meta(charset="utf-8") 
| <style type="text/css"> 
include main.css 
| </style> 


caption Zowie! Top Scorers! 
tr 
th Score 
th Name 
th Date 
if scores.length 
each score in scores 
if score 
tr 
td #{score.score} 
td #{score.first_name} #{score.last_name} 
td #{score.date} 


为 了 呈现 模板 ， 应 用 程序 首先 读 取 了 模板 文件 的 内 容 ( 我 们 使 用 了 同步 版 本 的 文件 读 
取 操作 ， 因 为 该 操作 只 在 应 用 程序 启动 时 执行 一 次 )， 然 后 用 它 来 编译 一 个 模板 函数 : 


var layout = require('fs').readFileSync(__dirname + '/score.jade', 'utf8'); 
var fn = jade.compile(layout, {filename: _ dirname + '/score.jade'})j; 


然后 , R a AeA eRe 2A aS Beet ay AEE AY EE Bae PKI 
数 呈 现 HTML T: 


var str = fn({scores : result}); 
res.end(str); 
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当 看 到 完整 的 服务 端 应 用 程序 后 ， 你 会 对 此 有 更 好 地 理解 。 现 在 ， 让 我 们 再 来 看 看 
应 用 程序 如 何 操作 Redis。 


排行 榜 程 序 需要 使 用 两 个 Redis KA: 首先 使 用 zrevrange 得 到 一 组 分 数 信 息 ， 然 
后 从 这 组 分 数 信息 中 取得 多 个 成 员 ID 信息 , 再 多 次 调用 hgetall 并 传人 不 同 的 成 员 
ID 以 获取 对 应 玩家 的 详细 信息 。 不 过 , 正 是 对 hgetall 的 调用 让 事情 变 得 有 点 环 手 。 


当 你 使 用 一 个 关系 型 数据 库 时 ， 你 可 以 轻松 地 将 多 个 表 的 结果 合并 。 但 在 类 似 于 
Redis 的 键 值 对 系统 中 ， 却 不 能 实现 该 功能 。 男 外 ， 由 于 这 是 一 个 Node 应 用 程序 ， 
我 们 还 需要 做 一 些 额 外 的 工作 来 保证 每 一 个 Redis 调用 都 是 异步 的 。 


这 正 是 流程 控制 模块 (如 Async ) 的 用 武之 地 。 我 曾 在 第 5 草 中 对 Async 做 了 说 明 
和 介绍 ， 并 示例 了 一 些 异步 方法 ( waterfall 和 parallel )， 有 一 个 没有 提 到 的 方法 是 
series ， 不 过 此 时 ， 它 是 我 们 的 理想 选择 。 对 hgetall 滑 数 的 多 次 调用 需要 按 顺 序 进 
行 ， 以 确保 返回 的 数据 是 有 序 的 , 但 每 一 个 调用 都 是 独立 的 ， 并 不 依赖 于 之 前 调用 
的 处 理 结 果 。Async 的 parallel 功能 会 并 行 执行 所 有 调用 ， 这 很 好 ,但 每 个 调用 的 
执行 结果 则 会 以 随机 顺序 返回 ， 无 法 保证 最 先 返 回 最 高 得 分 信息 。 另 外 , 我 们 也 没 
有 必要 使 用 waterfall 方法 ， 因 为 每 一 个 步骤 都 不 依赖 于 之 前 步骤 的 执行 结果 。 如 采 ， 
使 用 Async 的 series 方法 则 能 确保 每 一 个 hgetall 调用 及 返回 的 数据 都 是 按 序 进行 
的 ， 同 时 也 能 保证 每 个 调用 都 是 相互 独立 没有 依赖 关系 的 。 


现在 ,我 们 有 了 一 种 解决 方法 来 保证 按 序 调用 Redis 命令 ， 并 能 以 正确 的 顺序 返回 
数据 。 但 写 出 来 的 代码 却 看 起 来 很 笨拙 ， 因 为 我 们 必须 为 每 一 个 Redis.hgetall 调用 
书写 单独 的 步骤 并 处 理 返回 结果 ， 以 便 在 series 方法 中 使 用 它们 。 如 果 只 需要 5 个 
查询 结果 的 话 ， 这 不 是 什么 问题 ， 但 是 如 果 想 要 返回 10 个 结果 呢 ? 或 100 ^? F 
动 实现 每 个 Redis 调用 代码 并 将 其 放 在 Async.series 的 调用 序列 中 是 件 非 常 繁 琐 并 
很 容易 出 错 的 事情 ， 而 且 代 码 还 很 难 维护 。 


在 本 例 中 , 我 们 通过 一 个 循环 操作 , 将 Redis.zrevrange 返回 的 数组 中 的 每 个 成 员 ID 
值 传 给 MakeCallbackFunc 了 因数。 这 个 辅助 图 数 所 做 的 是 返回 一 个 回调 困 数 ， 这 个 
回调 函数 会 调用 Redis 的 hgetall 方法 并 传递 参数 来 确定 应 该 从 Redis 获取 哪个 成 员 
的 数据 ， 然 后 在 回调 函数 的 最 后 一 行 调 用 callback K% (Async 需要 它 来 取得 所 有 
步骤 的 处 理 结果 )。 使 用 MakeCallbackFunc 因 数 生成 的 所 有 回调 郧 数 都 会 被 保存 在 
一 个 数组 中 ， 这 个 数组 会 作为 一 个 参数 传递 给 Async.series 方法 。 此 外 ， 因 为 redis 
模块 会 将 hgetall 的 查询 结果 作为 对 象 返 回 ， 而 Async.series 子 数 执行 完 所 有 步骤 后 
会 将 这 些 对 象 保 存 到 一 个 数组 , 所 以 我 们 可 以 把 最 后 得 到 的 处 理 结果 直接 传递 给 模 
板 引 擎 用 以 生成 文本 信息 。 
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示例 9-3 是 分 数 排行 榜 服务 端 应 用 程序 的 完整 代 介 。 虽然 上 述 工 作 听 起 来 需要 很 大 
的 工作 量 , 但 实际 上 的 代码 并 不 多 ,这 要 感谢 Redis 寞 步 模块 以 及 Async 模块 的 优 
雅 和 可 用 性 了 。 


示例 9-3 游戏 排行 榜 服 务 端 程序 


var http = require('http' ); 
var async = require('async'); 
var redis = require('redis'); 
var jade = require('jade'); 


// set up Jade template 
var layout = require('fs').readFileSync(__dirname + '/score.jade', ‘utf8'); 
var fn = jade.compile(layout, {filename: _ dirname + '/score.jade'}); 


// start Redis client 
var client = redis.createClient(); 


// select fifth database 
client.select(5); 


// helper function 
function makeCallbackFunc(member) { 
return function(callback) { 
client.hgetall(member, function(err, obj) { 
callback(err,obj); 
})5 
}; 
} 


http.createServer(function(req,res) { 


// first filter out icon request 


if (req.url === '/favicon.ico’) { 
res.writeHead(200, {'Content-Type': 'image/x-icon'} ); 
res.end(); 
return; 

} 


// get scores, reverse order, top five only 
client.zrevrange('Zowie!',0,4, function(err,result) { 
var scores; 


if (err) { 
console. log(err); 
res.end('Top scores not currently available, please check back’); 
return; 

} 


// create array of callback functions for Async.series call 
var callFunctions = new Array(); 


// process results with makeCallbackFunc, push newly returned 

// callback into array 

for (var i = 0; i < result.length; i++) { 
callFunctions.push(makeCallbackFunc(result[i])); 

} 
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// using Async series to process each callback in turn and return 
// end result as array of objects 
async. series ( 
callFunctions, 
function (err, result) { 
if (err) { 
console.log(err); 
res.end('Scores not available'); 
return; 


} 


// pass object array to template engine 
var str = fn({scores : result}); 
res.end(str); 


}); 
}); 
}).listen(3000) ; 


console. log('Server running on 3000/'); 


在 创建 HTTP 服务 端 对 象 之 前 ， 我 们 建立 了 Jade 模板 函数 ， 同 时 还 建立 了 一 个 Redis 
客户 端 。 当 一 个 新 的 请 求 到 达 服 务 顺 时, 我 们 先 第 选 出 所 有 有 关 favicon.ico 文件 的 
请 求 ( 因为 请 求 ma 并 不 需要 调用 Redis )， 然 后 使 用 zrevrange Jy fiwe h 
前 五 个 最 高 得 分 。 一 旦 应 用 程序 取得 了 分 数 ， 它 便 会 使 用 Async.series 方法 来 处 理 
Redis 请 求 的 时 间 和 顺序 ， 以 便 能 得 到 一 个 有 序 结 果 。 最 终 查 询 结果 数 
组 会 被 传递 给 Jade 模板 引擎 。 


图 9-1 展示 了 在 添加 了 几 个 测试 数据 后 的 应 用 程序 处 理 结 果 。 





Bz Zowie! T Top $ Scores 














Q9-1 Zowie 游戏 得 分 排行 榜 
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9.3 创建 消息 队列 


消息 队列 是 一 个 将 输入 信息 作为 某 种 通信 形式 并 将 信息 存储 在 队列 中 的 应 用 程序 。 
消息 在 被 接收 前 一 直人 存储 在 队列 中 , 当 消 息 接 收 需 接收 它们 时 ,消息 会 被 弹出 队列 
并 传送 到 接收 硕 〈 消 息 数 量 可 以 是 一 个 或 批量 的 )。 这 种 通信 和 是 异步 的 ， 因 为 保存 
消息 的 应 用 程序 并 不 需要 与 消息 接收 需 连 接 。 同 样 的 , 消息 接收 应 用 程序 也 不 需要 
与 存储 消息 的 应 用 程序 连接 。 


Redis 是 实现 这 种 类 型 应 用 程序 的 理想 存储 媒介 。 当 产生 消息 的 应 用 程序 需要 保存 
消息 时 ， 它 将 消息 放 在 消息 队列 的 尾部 。 当 消息 接收 应 用 程序 检索 需要 的 信息 时 
它 会 从 消息 队列 前 面 取得 消息 。 


为 了 更 好 地 说 明 消 息 队 列 ， 我 创建 了 一 个 Node 应 用 程序 来 访问 几 个 不 同 子 域 的 
Web 日 志文 件 。 该 应 用 程序 使 用 一 个 Node 子 进 程 和 Unix 的 tail -f 命令 来 取得 不 同 
日 志文 件 的 新 增 条 目 。 应 用 程序 使 用 两 个 正则 表达 式 对 象 处 理 这 些 日 志 条 目 : 一 个 
用 于 提取 访问 的 资源 路 径 , 另 一 个 测试 资源 是 否 是 一 个 图 像 文件 。 如 果 访 问 的 资源 
是 一 个 图 像 文 件 , 应 用 程序 会 通过 TCP 消息 将 资源 的 URL 信息 发 送 到 消息 队列 应 
用 程序 。 


消息 队列 应 用 程序 所 做 的 只 是 监听 端口 3000 上 传人 的 消息 ， 然 后 将 它们 保存 到 
Redis 中 。 


接 下 来 还 需要 一 个 Web 服务 端 应 用 程序 ， 它 会 监听 端口 8124 上 的 用 户 请 求 。 对 于 
每 一 个 请 求 ， 它 会 访问 Redis 数据 库 并 取出 图 像 数据 存储 区 中 的 第 一 个 条 目 ， 再 通 
过 response 对 象 将 其 返回 给 客户 端 。 如 果 在 获取 图 像 资 源 的 时 候 Redis 数据 库 返 回 
null， 那 么 程序 会 输出 一 条 消息 来 表示 已 经 处 理 到 了 消息 队列 的 末尾。 


示例 9-4 展示 了 第 一 个 应 用 程序 的 代码 ， 它 用 于 处 理 Web 日 志 条 目 。Unix 的 tail 
命令 可 以 用 来 显示 一 个 文本 文件 的 最 后 几 行 (或 管道 的 数据 )。 当 使 用 -f 标志 时 ， 
该 实用 程序 就 会 在 显示 文件 的 最 后 几 行 后 进行 等 待 ， 监 听 是 否 有 新 条 目 被 添加 到 文 
件 。 当 有 新 条 月 被 添加 时 ， 它 就 返回 该 新 条 目 内 容 。tail 节 命 令 可 以 同时 监听 几 个 
不 同文 件 的 内 容 ， 当 任何 文件 有 新 内 容 到 达 时 , 它 会 输出 这 条 新 内 容 并 打上 对 应 的 
文件 标签 以 区 别 不 同 的 信息 源 。 我 们 的 程序 并 不 关心 最 新 条 目 是 在 哪 一 个 日 志文 件 
中 产生 的 ， 而 只 是 关心 条 目 内 容 。 


应 用 程序 获得 日 志 条 目 , 它 会 执行 两 个 正则 表达 式 来 匹配 条 目 数 据 ,， 以 便 确 定 
| ( 对 后 缀 名 为 jpg、.gif、.svg 或 .png 文件 的 访问 )。 如 果 找 
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到 史 配 项 ， 应 用 程序 会 将 资源 URL 发 送 到 消息 队列 应 用 程序 中 (一 个 TCP 服务 端 ) 
示例 9-4 Web 日 志 处 理 程 序 : 处 理 条 目 并 发 送 图 像 资 源 URL 到 消息 队列 程序 


var spawn = require('child process').spawn; 
var net = require('net'); 


var client = new net.Socket(); 
client.setEncoding('utf8'); 


// connect to TCP server 
client.connect ('3000','examples.burningbird.net', function() { 
console.log('connected to server'); 


i); 


// start child process 

var logs = spawn('tail', ['-f', 
'/home/main/logs/access.log', 
' /home/tech/logs/access.log', 
' /home/shelleypowers/logs/access.log', 
' /home/green/logs/access.log', 
' /home/puppies/logs/access.log']); 


// process child process data 
logs.stdout.setEncoding( 'utf8' ); 
logs.stdout.on('data', function(data) { 
// resource URL 
var re = /GET\s(\S+)\sHTTP/g; 


// graphics test 
var re2 = /\.gif|\.png|\.jpg|\.svg/; 


// extract URL, test for graphics 

// store in Redis if found 

var parts = re.exec(data); 

console. log(parts[1]); 

var tst = re2.test(parts[1]); 

if (tst) { 
client.write(parts[1]); 

} 


J); 
logs.stderr.on('data', function(data) { 
console.log('stderr: ' + data); 


})5 


logs.on('exit', function(code) { 
console.log('child process exited with code ' + code); 
client.end(); 


1 


运行 日 志 处 理 程序 后 可 以 得 到 类 似 于 下 面 的 控制 人 台 输 出 信息 ， 包 括 了 常见 的 Web 
访问 条 日 ， 并 以 粗 体 显 示 了 对 图 像 资 源 的 访问 条 日 : 


robots txt 
/weblog 
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/writings/fiction?page=10 
/images/kite. jpg 

/node/145 
/culture/book-reviews/silkworm 
/feed/atom/ 
/images/visitmologo. jpg 
/images/canvas.png 
/sites/default/files/paws.png 
/feeds/atom. xml 


示例 9-5 包含 了 消息 队列 程序 的 源 代 码 。 这 是 一 个 简单 的 Node 应 用 程序 ， 只 是 局 
动 了 TCP 服务 端 ， 并 侦 听 传人 的 消息 。 当 它 接 收 到 消息 后 ， 会 从 消息 中 提取 数据 
并 存储 在 Redis 的 数据 库 中 。 该 应 用 程序 使 用 了 Redis 的 rpush 命令 来 将 数据 保存 


到 名 为 images 的 列表 中 《代码 中 的 粗 体 部 分 )。 
示例 9-5 消息 队列 程序 . 处 理 传 入 的 消息 ， 并 将 其 保存 到 Redis 列表 


var net = require('net'); 
var redis = require('redis'); 


var server = net.createServer(function(conn) { 
console. log('connected'); 


// create Redis client 

var Client = redis.createClient(); 
client.on('error', function(err) { 
console.log('Error ' + err); 


}); 


// sixth database is image queue 
client.select(6); 
// listen for incoming data 
conn.on('data', function(data) { 
console.log(data + ' from ' + conn.remoteAddress + ' ' + 
conn.remotePort) ; 


// store data 

client.rpush( ‘images’ , data) ; 
Ps 
}).1isten(3000) ; 
server.on('close’, function(err) { 
client.quit(); 

}); 


console. log('listening on port 3000'); 


运行 消息 队列 应 用 程序 后 ， 对 应 的 控制 台 输 出 类 似 于 下 面 这 样 : 


listening on port 3000 
connected 
/images/venus.png from 173.255.206.103 39519 
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/images/kite.jpg from 173.255.206.103 39519 
/images/visitmologo.jpg from 173.255.206.103 39519 
/images/canvas.png from 173.255.206.103 39519 
/sites/default/files/paws.png from 173.255.206.103 39519 


示例 9-6 是 最 后 一 个 与 消息 队列 相关 的 示例 程序 , 它 是 一 个 HTTP 服务 端 并 在 端口 
8124 监听 来 自用 户 的 请 求 信息 。 当 该 程序 接收 到 HTTP 请 求 时 ， 它 会 访问 Redis 
数据 库 ， 并 从 images 列表 取得 图 像 信 息 条 目 ， 然 后 将 其 输出 给 用 户 。 如 果 列 表 中 
已 经 没有 更 多 条 目 时 ( 即 如 果 Redis 的 答复 返回 null), 它 则 会 输出 消息 队列 为 空 的 
提示 。 


示例 9-6 HTTP 服务 端 ， 从 Redis 列表 中 取得 消息 ， 并 返回 给 用 户 


var redis = require("redis"), 
http = require('http'); 


var messageServer = http.createServer(); 


// listen for incoming request 
messageServer.on('request', function (req, res) { 


// first filter out icon request 


if (req.url === '/favicon.ico') { 
res.writeHead(200, {'Content-Type': 'image/x-icon'} ); 
res.end(); 
return; 


// create Redis client 
var client = redis.createClient(); 


client.on('error', function (err) { 
console.log('Error ' + err); 


}); 


// set database to 1 
client.select(6); 


client.lpop('images', function(err, reply) { 
if(err) { 
return console.error('error response ' + err); 


} 


// if data 
if (reply) { 
res.write(reply + '\n'); 
} else { 
res.write('End of queue\n'); 


res.end(); 


}); 
client.quit(); 


})5 
messageServer. listen(8124) ; 
console. log('listening on 8124'); 


每 次 使 用 Web 浏览 器 访问 该 HTTP 服务 程序 时 ( 刷新 浏览 器 页 面 )， 都 会 得 到 一 个 
有 关 图 像 资源 的 请 求 信 息 ， 直 到 消息 队列 为 空 。 


何 时 创建 Redis 客户 端 ? 


在 本 章 的 一 些 示 例 代 码 中 ，Redis 客户 端 与 应 用 程序 具有 相同 生命 周期 。 但 是 ， 我 也 可 能 在 创 
建 Redis 客户 端 并 在 执行 完 相 应 的 Redis 命令 后 需要 尽快 释放 它 。 那 么 , 什么 时 候 应 该 创建 一 
个 持久 的 Redis 连接 ? 而 什么 时 候 立 即 释放 它 会 比较 好 呢 ? 

这 是 个 好 问题 。 


为 了 测试 这 两 种 不 同 的 使 用 方法 ， 我 创建 了 一 个 TCP 服务 端 并 监听 请 求 ， 然 后 简单 地 将 请 求 
内 容 存 储 在 一 个 Redis 数据 库 中 。 然 后 ,我 又 创建 了 另 一 个 应 用 程序 , 把 它 作 为 TCP 客户 端 ， 
能 将 一 个 对 象 放 在 TCP 报 文中 并 发 送 到 到 服务 端 。 


为 了 测试 ， 我 用 ApacheBench 程序 并 发 地 运行 多 个 客户 端 程序 并 观察 啊 应 时 间 。 第 一 次 测试 


使 用 长 生命 周期 的 Redis 客户 端 连接 ， 而 第 二 次 测试 使 用 立即 释放 Redis 客户 端 连接 。 


我 期 望 具有 持久 Redis 客户 端 连接 的 程序 会 更 快 一 些 , 测试 结果 表明 我 是 对 的 。 对 于 具有 持久 
Redis 连接 的 程序 ， 当 测试 进行 到 大 约 一 半 时 ,应 用 程序 的 啊 应 速度 在 一 个 短暂 的 时 间 内 大 幅 
下 降 ， 然 后 又 恢复 到 较 快 的 速度 。 


当然 ， 最 有 可 能 发 生 的 是 ，Redis 数据 库 的 请 求 队列 阻塞 了 Node 应 用 程序 ， 至 少 是 暂时 的 ， 
直到 队列 被 释放 。 我 在 测试 针对 每 个 请 求 都 打开 和 关闭 Redis 连接 的 服务 端 应 用 程序 时 , 并 没 
有 碰 到 同样 的 问题 。 这 可 能 是 因为 建立 Redis 连接 的 过 程 需要 额外 开销 ， 从 而 放 缓 了 对 Redis 
的 并 发 请 求 速度 ， 使 Redis 有 足够 时 间 处 理 请 求 。 

在 第 14 章 和 第 16 章 ， 我 会 使 用 ApacheBench 进行 更 多 相关 测试 ， 并 会 介绍 另 一 些 性 能 测试 
工具 。 





9.4 为 Express 应 用 程序 添加 统计 中 间 件 


Redis 的 最 初 设计 原本 是 用 来 实现 统计 应 用 程序 的 。 因 此 ， 使 用 Redis 的 理想 情 
况 是 : 一 个 简单 的 数据 存储 ， 能 文 持 快速 日 频繁 的 写 和 操作， 而 且 需 要 支持 统 
计 功 能 。 
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在 本 小 节 中 ,我 们 将 使 用 Redis 来 为 widget 应 用 程序 ( 之 前 章节 中 创建 的 示例 程序 ) 
提供 统计 功能 。 统 计 信 息 被 保存 在 两 个 集合 中 : 一 个 包含 了 所 有 曾 访问 过 widget 
程序 的 客户 端的 IP 地 址 ， 男 一 个 保存 了 不 同 widget 程序 资源 被 访问 的 次 数 。 为 了 
实现 该 功能 ， 我 们 需要 使 用 Redis 的 set 数据 结构 及 递增 数字 字符 串 功 能 。 另 外 ， 
应 用 程序 还 使 用 了 Redis 的 事务 控制 multi， 以 便 能 在 同一 时 间 取 得 两 个 独立 数据 
集合 的 内 容 。 


第 一 步 应 该 做 的 是 为 应 用 程序 添加 新 的 中 间 件 ， 该 中 间 件 能 将 访问 信息 保存 到 Redis 
数据 库 中 。 中 间 件 使 用 了 Redis 的 set 集合 并 使 用 sadd 方法 将 每 个 访问 者 的 IP 地 址 添 
加 到 集合 中 。set 集合 可 以 确保 一 个 已 经 存在 于 数据 库 中 的 值 不 会 被 记录 两 次 ， 因 为 我 
们 关注 于 收集 访问 者 的 PP 地 址 信息 ， 但 无 需 记 录 该 IP 用 户 的 每 次 访问 。 我 们 还 使 用 
了 Redis 的 增 量 功能 ， 但 并 没有 采用 用 于 递增 字符 串 的 incr 方法 ， 而 是 使 用 了 hincrby 
方法 。 因 为 资源 URL 及 其 关联 的 访问 计数 器 是 作为 哈 希 存储 在 Redis 中 的 。 

示例 9-7 展示 了 中 间 件 源 代码 ， 它 保存 在 statsjs 文件 中 。 中 间 件 使 用 了 Redis 数据 库 ， 
并 将 访问 者 的 IP 地 址 信息 保存 在 一 组 以 ip 为 标识 的 集合 中 ， 而 资源 URL 及 访问 
计数 需 被 保存 在 一 个 以 myurls 为 标识 的 哈 希 中 。 

示例 9-7 基于 Redis 的 统计 中 间 件 


var redis = require('redis'); 
module.exports = function getStats() { 


return function getStats(req, res, next) { 
// create Redis client 
var Client = redis.createClient(); 


client.on('error', function (err) { 
console.log('Error ' + err); 


2 


// set database to 2 
client.select(2); 


// add IP to set 
client.sadd('ip' ,req.socket.remoteAddress); 


// increment resource count 
client.hincrby('myurls' ,req.url, 1); 


client.quit(); 
next(); 


} 
由 于 统计 接口 需要 能 够 被 顶级 域名 访问 ， 因 此 我 们 将 在 routes FHKW index.js X 
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件 添加 相关 的 路 由 代码 。 
首先 ， 需 要 在 主 程序 文件 中 添加 路 由 ， 并 将 其 放 在 顶级 index 路 由 之 后 : 


app.get('/', routes.index) ; 
app.get('/stats',routes.stats); 


在 routes.stas 的 实现 代码 中 ， 我 们 调用 了 multi KAKE Redis 的 事务 控制 功 
能 。 这 段 代 码 访 问 了 两 组 数据 : 一 组 是 通过 smembers 返回 的 IP 地 址 信息 (不 
会 包含 重复 IP )， 另 一 组 是 通过 hgetall 返回 的 包含 有 资源 URL 及 访问 计数 需 的 
哈 希 表 。smembers 函数 和 hgetall 哨 数 被 按 序 调用 ,执行 结果 被 按 序 追 加 到 一 个 
数组 中 ， 并 最 终 作 为 exec 方法 回调 因数 的 参数 ， 如 示例 9-8 所 示 。 一 旦 拿 到 处 
HHR, FETA Ki stats 视图 。 在 index.js 文件 中 新 添加 的 代码 以 粗 体 
显示 。 


示例 9-8 包含 有 统计 程序 控制 代码 的 路 由 索引 文件 


var redis = require(‘redis'); 


// home page 
exports.index = function(req, res){ 
res.render('index', { title: ‘Express’ }); 


E 


// stats 
exports.stats = function(req, res){ 


var client = redis.createClient(); 
client.select(2); 


// Redis transaction to gather data 

client.multi() 

.smembers(‘ip') 

-hgetall(‘myurls') 

.exec(function(err, results) { 
var ips = results[0]; 
var urls = results[1]; 
res.render('stats',{ title: ‘Stats’, ips : ips, urls : urls}); 
client. quit(); 

3 


}; 
我 前 面 提 到 的 multi 和 exec 是 Redis 的 事务 控制 命令 。 它 们 与 关系 数据 库 的 事务 控制 
不 是 一 回 事 。multi 会 收集 一 组 Redis 命令 ， 在 执行 exec 时 ， 它 会 按照 顺序 处 理 这 一 
组 命令 。 这 种 功能 在 Node 中 是 非常 有 用 的 , 因为 它 提供 了 一 种 一 次 性 获取 多 个 集合 
数据 的 方式 ， 而 无 需 再 使 用 艇 套 回 调 函 数 或 流程 控制 模块 (如 Step 和 Async )。 
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说 了 这 么 多 , 不 要 让 这 些 串 起 来 的 Redis 命令 迷惑 了 你 ,不 要 认为 后 一 条 命令 的 执 
行 需要 依赖 于 前 一 条 命令 的 执行 结果 。 实 际 上 每 个 Redis 命令 的 处 理 都 是 相互 独立 
的 ， 只 是 所 有 处 理 结果 会 被 按 序 保 存在 一 个 数组 中 并 一 次 性 返回 。 


| 警告 

-S 事务 的 执行 过 程 中 是 没有 锁 的 ， 这 与 关系 型 数据 库 的 事务 有 所 不 
同 。 所 以 在 Redis 数据 库 查 询 过 程 中 的 任何 修改 都 可 能 会 影响 查 
询 结果 。 


最 后 我 们 还 需要 为 应 用 程序 添加 视图 ， 创 建 一 个 Jade 模板 。 这 个 模板 非常 简单 : 
所 有 IP 地 址 信息 会 在 一 个 无 序 list 中 呈现 ， 而 URL 和 计数 统计 信息 则 显示 在 一 个 
table 中 。 我 们 可 以 在 Jade 文件 中 使 用 for ... in 语法 来 遍历 包含 了 IP 地 址 信息 的 数 
组 ， 而 hgetall 方法 所 返回 对 象 中 的 属性 名 称 和 属性 值 则 可 以 通过 each ... in 语法 取 
得 。 示 例 9-9 展示 了 模板 文件 的 源 代 码 。 


示例 9-9 用 于 统计 应 用 程序 的 Jade 模板 


extends layout 


block content 
hi= title 


h2 Visitor IP Addresses 
ul 
for ip in ips. 
li=ip 


table 
Caption Page Visits 
each val, key in urls 
tr 
td #{key} 
td #{val} 
当 多 个 不 同 IP 地 址 访问 widget 应 用 的 不 同 资源 页 面 后 ， 我 们 会 得 到 一 个 类 似 于 图 
9-2 所 示 的 统计 页 面 。 


在 使 用 hincrby 函数 前 是 否 必 须 先 创建 哈 硕 表 呢 ? 答案 是 否定 的 。 如 果 对 应 的 哈 希 
键 不 存在 的 话 ，Redis 会 自动 创建 它 并 初始 化 哈 硕 值 为 0， 然后 再 对 其 做 递增 操作 。 
只 有 在 对 应 哈 希 键 存 在 但 哈 希 值 不 为 数字 型 字符 串 时 ，hincrby 操作 才 会 失败 ， 因 
为 我 们 不 能 对 非 数 字 型 字符 串 的 哈 硕 值 做 递增 操作 。 


另 一 种 实现 资源 访问 计数 的 方法 是 : 使 用 Redis 字符 串 ， 将 资源 URL 作为 key: 


client.incr (url); 


Firefox * 


| . Visitor HP Addresses 


173.258.206.103 
99.160.249 245 








9-2 基于 Redis 的 统计 页 面 


然而 ， 这 种 方法 意味 着 程序 必须 取得 所 有 key《〈 即 所 有 资源 的 URL 地 址 )， 然 后 再 
取得 每 个 URL 的 计数 器 值 。 此 时 , 我 们 无 法 单独 使 用 multi 来 完成 所 有 工作 。 如 果 
再 考虑 到 访问 数据 的 异步 特性 , 最 终 就 必须 使 用 舱 套 回调 或 其 他 方法 来 将 所 有 这 些 
数据 整合 在 一 起 。 


因此 ， 当 可 以 使 用 Redis 内 置 hash 以 及 hincrby 命令 来 完成 这 些 功 能 时 ， 我 们 就 没 
有 必要 再 花费 更 多 精力 来 实现 它们 了 。 
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第 10 章 


Node 和 MongoDB: 文档 中 心 数据 


第 9 章 介 绍 了 一 个 非常 受 欢 迎 的 NoSQL 数据 库 结 构 (Redis 的 key/value 对 ), 本 章 
介绍 另 一 个 : MongoDB 以 文档 为 中 心 的 数据 存储 。 


MongoDB 有 别 于 其 他 关系 型 数据 库 系统 ， 比 如 MySQL。 区 别 在 于 MongoDB 文 持 
将 数据 结构 存储 为 文档 ， 而 不 是 实现 传统 意义 的 table。 这 些 文档 被 编码 为 BSON， 
是 JSON 的 二 进 制 格式 ， 这 很 大 程度 上 解释 了 为 什么 MongoDB 很 受 JavaScript 开 
发 人 员 欢 迎 。 使 用 MongoDB ， 你 会 拥有 一 个 BSON 的 文档 而 不 是 一 个 table 中 的 
某 行 ， 你 会 有 一 系列 数据 集合 而 不 是 一 个 table。 


MongoDB 并 不 是 唯一 的 以 文档 为 中 心 的 数据 库 ， 其 他 一 些 这 类 型 的 数据 存储 包括 
Apache 的 CouchDB, Amazon 的 SimpleDB， 甚 至 是 很 久远 的 Lotus Notes。 很 多 现 
在 流行 的 基于 文档 的 数据 存储 对 Node 都 有 一 定 文 持 , 但 是 以 MongoDB 和 CouchDB 
为 首 。 我 选择 MongoDB 而 不 是 CouchDB 的 原因 与 选择 Express 架构 的 原因 一 致 : 
我 觉得 对 一 个 不 太 接 触 二 级 技术 (在 这 里 指数 据 存 储 ) 的 人 来 说 更 容易 学 习 Node 
的 使 用 而 不 用 关注 过 多 非 Node 的 技术 。 通 过 MongoDB 我 们 可 以 直接 查询 数据 ， 
而 CouchDB 需要 了 解 view 的 概念 。 高 级 别 的 抽象 需要 更 多 时 间 。 在 我 看 来 ,使 用 
MongoDB 比 CouchDB 能 更 快 地 达到 目的 。 


MongoDB 有 许多 模块 可 以 使 用 ,我 们 关注 两 个 : MongoDB 原生 Node.js 驱动 (用 
JavaScript 编写 的 驱动 ) 和 Mongoose, 一 个 对 象 模型 工具 提供 了 ORM (对象 关系 
映射 ，object-relational mapping ) 支持 。 
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提示 

尽管 本 章 不 会 讲 到 太 多 关于 MongoDB 的 工作 原理 ， 但 是 即使 你 以 前 
没有 用 过 这 种 数据 库 你 也 应 该 可 以 跟 上 以 下 这 些 例子 。 更 多 关于 
MongoDB 的 信息 包括 安装 帮助 参考 : http://www.mongodb.org/. 





10.1 MongoDB Native Node.js Driver (MongoDB 
原生 Node.js 驱动 ) 


MongoDB Native Node.js Driver 模块 是 MongoDB ArH Xt Node 的 驱动 ,该 驱动 发 
出 的 MongoDB 指令 与 MongoDB 客户 端 接口 发 出 的 指令 基本 一 致 。 


Ta 提示 
Node-mongodb-nativeGitHub 页 &: https://github.com/mongodb/node- 
S mongodb- native, 文档 参考 : http://mongodb.github.com/node-mongodb- 
native. 


安装 完成 MongoDB 之 后 (根据 MongoDB 官网 的 指南 ), 局 动 数 据 库 ,安装 MongoDB 


Native Node.js Driver: 


npm install mongodb 


在 开始 学 习 之 后 的 例子 之 前 ， 确 保 MongoDB 本 地 安装 完成 并 运行 。 


aise He 

z = FA 

= 如 果 你 已 经 使 用 了 MongoDB, 在 开始 本 章 的 例子 之 前 确保 对 数据 库 
中 的 数据 做 好 备份 。 


10.1.1 MongoDB AI] 
你 需要 引用 模块 才能 使 用 MongoDB 驱动 : 


var mongodb = require('mongodb'); 


之 后 构造 mongodb.Server 对 象 来 建立 MongoDB 数据 库 的 连接 : 


var server = new mongodb.Server('localhost', :27017, {auto_reconnect:true}) ; 


所 有 与 数据 库 的 连接 都 是 TCP 连接 。Server WAI KAAI TERN host 主机 号 
和 port 端口 号 ， 本 例 中 为 localhost 和 27017 端口 。 第 三 个 参数 可 选 。 在 代码 中 ， 


Node 和 MongoDB: 文档 中 心 数据 207 


auto_reconnect 选项 被 设置 为 true, 表示 如 果 连 接 断 开 driver 会 自动 进行 重 连 。 另 一 
个 选项 是 poolSize， 决 定 了 并 发 的 TCP 连接 数量 。 

提示 

MongoDB 为 每 个 连接 新 建 一 个 线程 ， 这 就 是 为 什么 数据 库 创 建 者 推 
BARA REA ERR, 





完成 了 与 MongoDB 的 连接 后 ， 就 可 以 创建 一 个 数据 库 或 者 连接 到 一 个 现 有 的 数据 
库 。 可 以 构造 mongodb.Db 对 象 创建 数据 库 : 


var db = new mongodb.Db('mydb', server); 


第 一 个 参数 为 数据 库 名 称 ， 第 二 个 为 建立 好 连接 的 MongoDB server。 第 三 个 参数 
表示 选项 。 默 认 选 项 对 于 本 章 需 要 做 的 工作 来 说 已 经 足够 ，MongoDB 文档 中 描述 
了 不 同 选项 的 意义 以 及 值 的 设 定 ， 在 这 里 不 再 重复 。 


如 果 你 之 前 没有 使 用 过 MongoDB ， 你 可 能 会 注意 到 在 代码 中 并 没有 提供 用 户 名 和 
密码 作为 认证 。 默 认 情 况 下 ，MongoDB 不 需要 认证 。 在 没有 验证 的 情况 下 ， 需 要 
确保 数据 库 运 行 在 一 个 安全 的 环境 下 。 这 意味 着 MongoDB 只 人 允许 来 自 于 信任 的 主 
机 的 连接 ， 主 要 是 localhost 地 址 。 


10.1.2 ” 定义、 创建 以 及 销毁 MongoDB Collection 


MongoDB collection 与 关系 型 数据 库 中 的 table 从 根本 上 来 说 功能 一 致 ,但 是 与 table 
并 没有 任何 形式 上 的 相似 之 处 。 


当 你 定义 一 个 MongoDBcolletion 的 时 候 ， 你 可 以 描述 是 否 希 望 立 即 创建 这 个 
colletion 对 象 ， 或 者 在 添加 第 一 行 数据 后 再 创建 。 使 用 MongoDB driver， 以 下 两 行 
代码 描述 了 不 同 的 情况 : 第 一 行 并 没有 创建 实际 的 colletion ， 第 二 个 则 创建 了 : 


db.collection('mycollection', function(err, collection{})); 
db.createCollection('mycollection', function(err, collection{})); 


以 上 两 个 方法 都 可 以 接收 第 二 个 参数 作为 可 选项 ，{safe: true} ,该 参数 用 于 在 
db.collection 中 collection 不 存在 或 者 db.createCollection 中 collection 存在 的 情况 下 
告知 driver 错误 信息 : 


db.collection('mycollection', {safe:true},function(err, collection{})); 
db.createCollection('mycollection', {safe:true},function(err, collection{})); 


如 果 你 对 一 个 已 经 存在 的 collection 使 用 db.createCollection 方法 , 你 可 以 直接 访问 
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该 collection driver 并 不 会 履 盖 这 一 部 分 。 两 种 方法 都 在 callback KR PIR [Fl 
collection 对 象 ， 你 可 以 对 其 进行 添加 ， 修 改 或 者 获取 数据 。 


如 果 和 希望 彻底 销毁 一 个 collection， 可 以 使 用 db.dropCollection: 


db.dropCollection('mycollection', function(err, result){}); 


值得 注意 的 是 ， 如 果 你 希望 按 顺 序 处 理 命令 , 所 有 这 些 方 法 都 是 同步 的 , 并 且 依 赖 
于 舱 套 的 回调 函数 。 这 在 下 一 节 我 们 为 collection 添加 数据 的 时 候 会 详细 说 明 。 


10.1.3 “为 Collection 添加 数据 


在 开始 了 解 如 果 向 collection 中 添加 数据 以 及 实现 功能 之 前 ， 我 想 花 点 时 间 讨 论 下 
数据 类 型 。 更 确切 地 说 ， 我 想 重复 一 下 MongoDB driver 文档 中 提 到 的 数据 类 型 ， 
因为 JavaScript 的 使 用 导致 了 driver 与 MongoDB 之 间 一 些 有 趣 的 约定 。 


表 10-1 显示 了 一 些 MongoDB 支持 的 数据 类 型 以 及 对 应 的 JavaScript 类 型 。 注 意 到 
大 部 分 的 数据 类 型 转换 很 彻底 , 不 会 囊 来 任何 超出 预期 的 影响 。 但 是 一 些 类 型 需要 
一 些 背后 的 处 理 机 制 ， 你 应 当 对 这 部 分 有 所 了 解 。 并 且 一 些 数据 类 型 由 MongoDB 
Native Node.js Driver 提供 ， 并 没有 对 等 的 MongoDB 数值 。Driver 将 我 们 提供 的 数 
据 转 换 为 MongoDB 可 以 接收 的 数据 。 


表 10-1 Node.js MongoDB driver 5 MongoDB 数据 类 型 的 映射 关系 





MongoDB 类 型 | JavaScript 类 型 | ”备注 /例子 

JSON 数组 [1,2,3]. 

String Utfs 编码 

Boolean True, false 
MongoDB 支持 32-64bit AYA, JavaScript number 是 
64bitfloat, MongoDB driver ein ¥ : 

eee eee 2btt HORSE, SEB Sdit, MARIAN, IIR 
换 为 Long 类 型 

Interger Long 类 型 支持 64bit interger 

Float 

Float 用 于 表示 float 值 的 特殊 类 型 

Regular expression 

Null 

Object 

Object id 用 于 表示 MongoDB id 的 特殊 类 
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MongoDB 类 型 备注 /例子 


Binary Class | 存储 二 进 制 数据 类 型 
i Code Class 存储 JavaScript 函数 和 方法 

DbRef Class 存储 对 另 一 个 文档 的 引用 

Symbol class 描述 符号 〈 对 于 符号 语言 不 仅 是 JavaScript) 





当 你 已 经 有 了 collection 之 后 , 就 可 以 加 collection 中 添加 文档 。 数 据 格 式 为 JSON， 
所 以 你 可 以 创建 一 个 JSON 对 象 ， 然 后 百 接 将 其 添加 到 collection。 


示例 10-1 创建 了 第 一 个 MongoDBcollection (4A Widgets )， 并 添加 了 两 个 文档 来 
说 明 如 何 向 collection 中 添加 数据 。 你 可 能 会 多 次 运行 这 个 例子 ， 所 以 先 用 remove 
方法 删除 已 有 的 collection 文档 以 防 创建 失败 。remove 方法 接收 三 个 可 选 参 数 : 


。 文档 的 选择 器 。 如 果 没 有 该 参数 ， 所 有 文档 会 被 删除 ; 
e = safe 模式 标识 ，safe {true | {w:n, wtimeout:n} | {fsync:true}, default:false} ; 
e 回调 函数 ( 如 果 safe 模式 被 设置 为 true NUMA [el Val eR). 


在 例子 中 ， 程 序 使 用 了 safe 模式 的 remove 方法 ， 第 一 个 参数 为 null ( 作为 参数 的 占 位 
符 ， 表 示 所 有 文档 会 被 删除 )， 并 提供 了 回调 函数 。 当 文档 被 删除 后 ， 程 序 会 插入 两 个 
新 的 文档 , 第 二 个 文档 搬入 时 使 用 了 safe 模式 。 程序 将 第 二 次 插入 的 结果 输出 到 控制 台 。 


insert 方法 也 接收 三 个 参数 : 文档 或 者 佛 添 加 的 文档 ， 可 选 参数 ， 回 调 晒 数 。 你 可 
以 用 数组 一 次 插入 多 个 数据 ，insert 方法 的 可 选 参数 为 : 


Safe 模式 
safe { true | {w:n, wtimeout:n} | {fsync:true}, default:false} 
keepGoing 
设置 为 true 时 ， 当 插入 文档 报错 时 会 继续 执行 后 续 代 码 。 
serializeFunctions 
文档 中 的 序列 化 方法 。 


insert 方法 的 调用 是 异步 的 ， 意 味 着 没 办 法 保证 第 一 个 文档 一 定 在 第 二 个 文档 之 前 
插入 。 但 这 一 点 在 widget 这 个 程序 中 不 构成 问题 ， 至 少 在 这 个 例子 中 。 本 章 稍 后 
的 部 分 我 们 会 详细 了 解 关 于 数据 库 异 步 操作 的 问题 。 
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示例 10-1 创建 /打开 数据 库 ， 删 除 所 有 文档 并 添加 两 个 新 的 文档 


var mongodb = require('mongodb'); 


var server = new mongodb.Server('localhost', 27017, {auto_reconnect:true}); 
var db = new mongodb.Db('exampleDb', server); 
// 打开 数据 库 连 接 
db.open (function (err, db) { 
if ('err) { 


// 访问 或 者 创建 widgets collection 


db.collection('widgets', function (err, collection) { 


// 删除 所 有 widgets 数据 文档 
collection.remove(null, {safe:true}, function (err, result) { 
if ('terr) { 
console.log('result of remove ' + result); 


// 创建 两 条 数据 

var widgetl = {title:'First Great widget', 
desc: "greatest widget of all', 
price:14.99}; 

var widget2 = {title:'Second Great widget', 
desc: 'second greatest widget of all', 
price:29.99}; 


collection.insert (widgetl]1) ; 


collection.insert (widget2, {safe:true}, function (err, result) { 
if (err) { 
console.log(err); 
} else { 
console.log(result); 


/ /关闭 数据 库 连 接 
db.close(); 


第 二 次 数据 插入 完成 后 输出 到 控制 台 的 内 容 是 一 个 变量 : 
[ { title:'Second Great widget', 


desc:'second greatest widget of all', 
price:29.99, 


_id:4fcl08e2f6b7a3e252000002 } | 


MongoDB 为 每 一 个 文档 都 生成 唯一 的 系统 标识 待 。 你 可 以 用 这 个 标识 符 访 问 特定 文 
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档 ， 但 是 你 可 以 为 每 个 文档 添加 一 个 更 有 意义 的 唯一 标示 符 一 可 以 由 使 用 的 语 境 决 定 。 


我 们 之 前 提 到 过 ， 可 以 用 数组 的 形式 一 次 添加 多 个 文档 。 以 下 代码 演示 了 两 个 
widget 记录 如 何 用 一 条 命令 插入 数据 库 的 ， 同 时 也 使 用 了 id: 


/ /创建 两 条 数据 
var widgetl = {id:1, title:'First Great widget', 
desc: 'greatest widget of all', 
price:14.99}; 
var widget2 = {id:2, title:'Second Great widget', 
desc: 'second greatest widget of all', 
price:29.99}; 
collection.insert([widgetl, widget2], {safe:true}, 
function(err, result) { 
if (err) { 
console.log(err); 
} else { 
console.log (result); 


// close database 
db.close(); 
} 
} ) ; 


如 果 你 选择 批量 处 理 文档 数据 ， 你 可 能 需要 设置 keepGoing 属性 为 tue。 这 样 即 使 
中 间 的 某 个 文档 操作 失败 也 可 以 继续 后 续 文 档 的 操作 。 上 默认 情况 下 ， 如果 一 个 操作 
失败 程序 就 会 终止 


10.1.4 ”查询 数据 


对 于 MongoDB Native Node.js Driver 来 说 有 四 种 查询 数据 的 方法 : 


find 

返回 查询 语句 查 到 的 所 有 文档 指示 。 
findOne 

返回 查询 语句 查 到 的 第 一 个 文档 。 
findAndRemove 

找到 查询 的 文档 并 删除 。 
findAndModify 


找到 查询 的 文档 并 进行 操作 ( 比如 remove 或 者 upsert ). 
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本 节 中 我 会 使 用 collection.find 和 collection.findOne 两 种 方法 ， 另 外 两 个 方法 会 在 
10.1.5 小 节 讲 到 。 


collection.find 和 collection.findOne 都 支持 以 下 三 个 参数 : 查询 语句 ， 可 选 参 数 ， 回 
调 困 数 。 可 选 参数 和 回调 上 数 都 是 可 选项 ， 并 且 这 两 个 方法 的 选项 可 选 值 非常 多 。 
表 10-2 显示 了 所 有 选项 ， 默 认 值 以 及 对 每 个 选项 的 描述 。 


表 10-2 
a a 
Limit 显示 返回 的 文档 数目 (0 表示 无 限制 ) 
Sort 对 查询 语句 返回 的 文档 排序 
om 查询 语句 返回 的 field。 使 用 属性 名 作为 key， 值 
Field Object 为 1 表示 返回 该 field， 为 0 表示 不 返回 该 field; 
比如 {人 prop”:1} 或 者 {prop”:0}， 但 不 能 同时 出 现 
Skip 表示 skip n 个 文档 (用 于 分 页 ) 
Hint 告诉 数据 库 使 用 特定 的 索引 ，{*_id”:1} 
Explain 解释 查询 语句 而 不 是 返回 数据 
Snapshot 抓拍 查询 语句 (必须 激活 MongoDB 的 journaling) 
Tailable Boolean, BRi\2 false | XXXXXXXXX 
batchSize 对 结果 遍历 时 getMoreCommand 的 batchSize 
returnKey 只 返回 索引 key 
maxScan 设置 可 查询 的 数据 项 数目 
Min ERDAN 
va rr 
showDiscLoc 显示 结果 在 磁盘 中 的 位 置 
Comment 为 查询 在 log 中 添加 描述 
Raw 返回 BSON 结果 作为 原始 缓冲 文档 
Read 将 查询 定向 到 二 级 服务 器 


尽管 大 部 分 查询 只 使 用 到 上 述 列表 中 的 一 小 部 分 选项 ， 但 是 这 些 选项 增加 了 查询 过 程 
的 灵活 性 。 例 子 中 只 会 涉及 其 中 一 些 选 项 ， 所 以 推荐 你 们 目 己 尝试 一 下 其 他 的 选项 。 


对 collection 中 所 有 文档 内 容 来 说 最 简单 的 查询 就 是 不 带 任 何 参数 的 find 方法 。 你 
可 以 直接 用 toArray 方法 将 结果 转换 为 数组 ， 传 递 给 接收 错误 信息 和 文档 数组 的 回 
调 函 数 作为 参数 。 示 例 10-2 代码 描述 了 上 述 功能 : 
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示例 10-2 插入 四 条 文档 数据 然后 用 find 方法 获取 该 数据 


var mongodb = require('mongodb') ; 


var server = new mongodb.Server('localhost', 27107, {auto_reconnect:true}) ; 
var db = new mongodb.Db('exampleDb', Server); 


// 打 开 数 据 库 连 接 


db.open(function(err,db)) { 
if(!err) { 


// 访 问 或 者 创建 widgets 文档 


db.collection('widgets', function(err, collection) { 


// 删 除 所 有 widgets 文档 
collection.remove (null, {safe:true}, function(err, result) { 
if (terr) { 
/ /创建 四 条 记录 
var widgetl = {id:1, title:'First Great widget', 
desc: 'greatest widget of all', 
price:14.99, type:'A'}; 
var widget2 = {id:2, title:'Second Great widget', 
desc: 'second greatest widget of all', 
price:29.99, type:'A'}; 
var widget3 = {id:3, title:'third widget', desc:'thirdwidget', 
price:45.00, type:'B'}; 
var widget4 = {id:4, title: 'fourth widget', desc: "fourth widget', 
price:60.00, type:'B'}; 


collection.insert ([widget1l,widget2,widget3, widget4], 
{safe:false}, 


function(err,result) { 
if(err) { 
console.log(err); 
telse { 


// 返 回 所 有 文档 
collection.find().toArray(function(err,docs) { 
console.log (docs); 


// 关 闭 数据 库 连 接 
db.close(); 
F)? 


输出 到 控制 台 的 查询 结果 会 显示 四 个 新 添加 的 文档 ， 以 及 系统 生成 的 id: 


[ { id:1, 
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title:'First Great widget', 

desc: 'greatest widget of all', 

price:14.99, 

type: 'A', 

_id:4fc109ab0481b9f£652000001}, 
{ id:2, 

title:'Second Great widget', 

desc:'second greatest widget of all', 

price: 29.99, 

type: 'A', 

_id:4fc109ab0481b9f652000002}, 
{ 1đd:3; 

title: 'third widget', 

desc: 'third widget', 

price:45, 

type: *B*, 

_id:4fc109ab0481b9f652000003}, 
{ id:4, 

title: "fourth widget', 

desc:'fourth widget', 

price: 60, 

type: °B", 

_id:4fc109ab0481b9f652000004 } Jj 


如 果 不 希 望 返回 所 有 内 容 , 我 们 可 以 提供 选择 器 。 在 以 下 代码 中 , 我 们 查询 所 有 具 
有 type 为 A 的 数据 ， 返 回 除 type 之 外 的 所 有 field: 


// 返 回 所 有 文档 
collection.find({type:'A'}, {fields:{type:0}}).toArray(function (err, docs) { 
if(err) { 
console.log(err); 
} else { 
console.log (docs); 


// 关 闭 数据 库 连 接 
db.close(); 
} 
} ) ; 


查询 结 采 为 : 


[ { id:1, 
title:'First Great widget', 
desc: 'greatest widget of all', 
price:14.99, 
_id:4f7ba035c4d2204c49000001 }, 

{ id:2, 

title:'Second Great widget', 
desc:'second greatest widget of all', 
price:29.99, 
_id:4f7ba035c4d2204c49000002 } ] 
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我 们 也 可 以 使 用 findOne 访问 一 条 数据 。 这 样 查询 的 结果 并 不 需要 被 转换 为 数组 ， 
可 以 直接 访问 。 以 下 代码 查询 了 ID 为 1 的 文档 ， 只 返回 title: 
// 返 回 一 个 文档 
collection.findOne({id:1}, {fields:{title:1}}, function (err, doc) { 
if (err) { 
console.log(err); 


} else { 
console.log(doc); 


// 关 闭 数据 库 连 接 
db.close(); 


{ title: 'First Great widget', _id: 4£7ba0fcbfede06649000001 } 
系统 生成 的 唯一 标识 符 总 会 出 现在 查询 结果 中 。 


即使 我 修改 了 查询 语句 返回 所 有 type 为 A 的 数据 (有 两 条 )，collection.findOne 方 
法 也 只 会 返回 一 个 。 在 选项 参数 中 改变 limit 的 值 没 有 任何 变化 ， 查询 成 功 的 情况 
下 永远 只 返回 一 条 结果 。 


10.1.5 使 用 Updates, Upserts, Find 和 Remove 


MongoDB Native Node.js Driver 文 持 几 种 修改 或 者 删除 文档 的 方法 ， 或 者 同时 进行 
以 上 两 个 操作 。 


update 
更 新 或 者 upserts ( 如 果 不 存 在 就 添加 ) 文档 。 


remove 
删除 文档 。 
findAndModify 
查找 并 修改 或 者 删除 一 个 文档 ( 返回 被 修改 或 者 删除 的 文档 )。 
findAndRemove 


查找 并 删除 一 个 文档 ( 返回 被 删除 的 文档 ) 
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update/remove 和 findAndModify/findAndRemove 之 间 最 本 质 的 区 别 就 在 于 后 者 的 两 
个 方法 都 返回 了 被 操作 的 文档 。 


这 些 方 法 的 使 用 与 之 前 看 到 的 insert 没有 太 大 区 别 。 你 需要 创建 一 个 数据 库 连 接 ， 
找到 你 想 要 的 都 个 文档 案 引 ， 然 后 进行 操作 。 


如 果 MongoDB 现在 有 以 下 数据 : 


{id: 4， 
title: 'fourth widget', 
desc: 'fourth widget'. 
price: 60.00, 
type: '8'} 


当 你 想 要 修改 title 的 时 候 可 以 使 用 update 方法 ， 如 示例 10-3 所 示 。 你 可 以 提供 所 
有 的 field, MongoDB 会 对 文档 进行 全 部 替换 。 但 是 更 好 的 方法 是 使 用 MongoDB 
修改 方法 ， 比 如 $set。$set 修改 符号 告诉 数据 库 只 修改 作为 属性 传递 给 修改 器 的 field。 


示例 10-3 更 新 一 个 MongoDB 文档 


var mongodb = require('mongodb'); 
var server = new mongodb.Server('localhost', 27017, {auto_reconnect:true}) ; 
var db = new mongodb.Db('exampleDb', server); 


// 打开 数据 库 连 接 
db.open (function (err, db) { 
if (!terr) { 
// 访问 或 者 创建 widgets collection 


db.collection('widgets', function (err, collection) { 


// 更 新 
collection.update({id:4}, 
{$set:{title:'Super Bad Widget'}}, 
{safe:true}, function (err, result) { 
if (err) { 
console.log (err); 
} else { 
console.log (result); 
// 查询 更 新 的 文档 
collection.findOne({id:4}, function (err, doc) { 
if (!err) { 
console.log (doc); 


// 关 闭 数据 库 
db.close(); 
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})3 
} 
}) ; 


结果 返回 的 文档 显示 了 修改 的 区 域 。 


a >. 提示 
$set 中 可 以 添加 多 个 field. 
s 


还 有 其 他 一 些 修 改 符号 用 于 原子 数据 更 新 : 
$inc 

对 某 一 个 field 的 值 增加 指定 数值 。 
gset 

如 例子 所 示 ， 设 置 某 个 field。 
Sunset 

删除 一 个 field. 
$push 

如 果 field 是 一 个 数组 ， 给 数组 中 添加 一 个 数值 (如果 不 是 数组 则 转换 为 数组 )。 
$pushAll 

向 数组 中 添加 几 个 值 。 
$addToSet 

只 有 field 为 数组 时 添加 值 到 该 数组 。 
$pull 

从 数组 中 删除 一 个 元 素 。 
$pullAll 

一 次 性 从 数组 中 删除 几 个 元 素 。 


$rename 


重 命 名 一 个 field. 
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Sbit 
按 位 操作 。 


我 们 为 什么 不 是 直接 删除 文档 然后 插入 一 条 新 的 数据 而 是 选择 修改 呢 ? 原因 在 于 ， 
尽管 我 们 需要 提供 所 有 用 户 定 义 的 field， 但 不 包括 系统 生成 的 唯一 标识 符 。 在 更 新 
过 程 中 该 标识 符 不 变 。 如 果 在 男 一 个 文档 中 这 个 标识 符 被 当做 某 个 field 存储 ， 比 
如 父 文档 ， 删 除 该 id 的 文档 会 使 父 文档 中 的 该 元 素 失 去 依赖 。 


aa 提示 
我 在 本 章 不 涉及 关于 树 (复杂 的 父子 数据 结构 ) 的 概念 ，MongoDB 
S 官网 有 关于 这 一 结构 的 文档 。 


更 重要 的 一 点 是 , 修改 方法 确保 了 操作 发 生 在 正确 的 位 置 , 一 定 程度 上 保证 一 个 用 
户 的 更 新 不 会 履 盖 为 一 个 的 。 


在 例子 中 没有 使 用 update 的 参数 ，update 方法 接收 四 个 参数 : 
e ”safe， 用 于 安全 更 新 ，; 


e upsert， 布 尔 值 ， 设 置 为 true 表示 如 果 文 档 不 存在 则 执行 insert 操作 (默认 为 
false) ; 


e multi， 布尔 值 ， 设 置 为 true 表示 所 有 符合 选择 条 件 的 文档 都 要 被 更 新 ; 
e ”serializFunction 使 文档 中 所 有 方法 序列 化 。 
示 如 果 你 不 确定 数据 库 是 否 包 含 某 个 文档 ， 设 置 upsert 选项 为 true。 


示例 10-3 在 修改 的 结果 上 做 了 一 次 查找 操作 以 确保 该 文档 确实 被 修改 了 。 男 一 种 
较 好 的 方法 是 使 用 findAndModify。 该 方法 参数 与 update 基本 一 致 ， 添 加 了 数组 作 
为 第 二 个 参数 。 如 果 返 回 多 个 文档 查询 结果 ，update 按 顺 序 执行 。 


// 更 新 
collection.findAndModify({id:4}, [[til]], 
{Sset:{title:'Super Widget', desc:'A really great widget'}}, 
{new:true}, function (err, doc) { 
if (err) { 
console.log(err) ; 
} else { 
console.log(doc) ; DB 
} 
db.close(); 
}); 
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还 可 以 使 用 remove 选项 利用 findAndModify 方法 删除 某 个 文档 ， 不 过 这 样 的 话 回 
调 困 数 中 没有 任何 返回 结果 。 还 可 以 使 用 remove 和 findAndRemove 方法 进行 删除 。 
之 前 的 例子 在 插入 数据 前 直接 使 用 remove， 不 设置 选择 器 ， 删 除了 全 部 文档 。 提 
供 选 择 器 可 以 删除 指定 的 某 个 文档 : 


collection.remove({id:4}, 
{safe:true}, function (err, result) { 
if (err) { 
console.log(err); 
} else { 
console.log(result); 


} 


result 为 删除 的 文档 数目 ( 本 例 中 为 1 )。 查 看 被 删除 的 文档 使 用 fndAndRemove: 


collection. findAndRemove ({id:3}, [['id', 1]], 
function (err, doc) { 
if (err) { 
console.log(err); 
} else { 
console.log (doc); 
} 
} ) 


到 这 里 我 们 已 经 介绍 了 从 Natibe driver Node 应 用 可 以 完成 的 基本 的 CRUD 操作 
(creae, read, 、update、delete )， 还 有 其 他 更 多 的 功能 ， 比 如 固定 集合 、 索 引 、 其 他 
一 些 MongoDB EMIF., TE (BULT KAE ) o Native driver 的 文档 对 此 有 
完善 的 例子 进行 说 明 。 


这 些 例子 中 有 一 些 关 于 异步 环境 下 的 数据 访问 的 问题 , 会 下 面 的 “异步 数据 访问 的 
挑战 ”说 明 栏 中 详细 讨论 。 


异步 数据 访问 的 挑战 


异步 开发 和 数据 访问 的 一 个 挑战 是 为 了 确保 一 个 操作 在 下 一 个 操作 开始 前 完成 所 做 的 能 套 的 
层次 问题 。 在 最 后 几 节 中 ， 你 会 看 到 只 是 一 些 简单 的 操作 回调 也 数 很 快 地 成 为 般 套 关系 ， 比 
如 访问 MongoDB， 获 取 collection， 进 行 某 种 操作 以 及 验证 操作 是 否 发 生 。 


MongoDB Native Node.js Driver 文档 包含 一 些 实例 , 开发 人 员 使 用 timer ( 定时 器 ) 来 确保 
下 一 个 方法 执行 前 上 一 个 方法 已 经 结束 。 你 不 会 想 要 使 用 这 种 实现 方式 的 。 为 了 避 倪 回调 
困 数 深层 次 衣 套 带 来 的 问题 ， 你 可 以 使 用 命名 因数 ， 或 者 某 些 异步 模块 ， 比 如 Step 和 
AsynCo 
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事实 上 最 好 的 实现 方式 是 确保 更 新 数据 库 的 每 个 方法 中 都 做 了 只 实现 最 小 的 功能 块 。 如 果 你 
努力 避免 左 套 回调 函数 ， 程 序 又 很 难 切换 使 用 一 些 类 似 Async 的 模块 ， 可 能 的 原因 在 于 每 个 
方法 中 所 做 的 操作 太 多 了 。 这 种 情况 下 ， 你 需要 将 复杂 的 对 数据 库 多 操作 的 函数 分 解 为 可 控 
制 的 单元 。 


评价 异步 编程 最 重要 的 一 点 就 是 简单 。 


10.2 使 用 Mongoose 实现 Widget 模块 


MongoDB Native Node.js Driver 提供 了 对 MongoDB 数据 库 的 绑 定 ， 但 是 没有 更 高 
级 别 的 抽象 。 所 以 你 需要 使 用 类 似 Mongoose 的 ODM ( object-document mapping, 
对 和 象 文档 映射 )。 
TEE 
Mongoose 官网 : http://mongoosejs.com/. 
te" a 
oy 


安装 Mongoose: 
npm install mongoose 


不 同 于 之 前 的 直接 对 MongoDB 发 出 命令 进行 操作 , 首先 使 用 Mongoose Schema 定 
义 对 象 ， 然 后 用 Mongoose model 对 象 同步 数据 库 : 


var Widget = new Schema ({ 
sn: {type: String, require: true, trim:true,unique:true}, 
name: {type:String, required: true, trim:true}, 


desc: String, 
price: Number 


}); 
var widget = mongoose.model ('Widget', Widget); 


当 我 们 定义 对 象 时 ， 我 们 提供 了 之 后 对 文档 中 field 的 控制 。 在 上 段 代 码 中 ， 我 们 
定义 了 一 个 Widget 对 象 ， 有 三 个 类 型 为 String， 一 个 类 型 为 Number 的 field。sn 
和 name 字段 都 是 必需 的 trim ( 删 去 首尾 空格 )， 并 且 sn 字段 在 该 文档 中 必须 是 唯 
一 的 。 


Collection 在 此 时 还 没有 被 创建 ， 直 到 有 一 个 文档 被 创建 之 后 才 会 有 Collection。 创 
建 出 来 的 collection 被 命名 为 widgets 一 一 widget， 对 象 名 是 小 写 并 且 复 数 形式 。 


任何 时 候 访 问 该 collection ， 用 同样 的 方法 调用 mongoose.model。 





Node 和 MongoDB: 文档 中 心 数据 221 


上 段 代 码 是 讲 添加 widget 程序 MVC 实现 的 最 后 一 个 部 分 的 第 一 步 。 接 下 来 的 几 节 
中 ， 我 们 会 完成 从 内 存 数据 存储 到 MongoDB 的 转换 。 不 过 首先 我 们 要 对 Widget 
程序 做 一 些 重 构 。 


10.3 重 构 Widget 工厂 


重 构 是 指 对 现 有 代码 结构 的 调整 过 程 , 在 基本 不 影响 用 户 接口 的 前 提 下 使 代码 和 结 
构 变 得 清晰 简单 。 既 然 我 们 现在 正在 对 widget 程序 使 用 MongoDB 做 修改 ,刚好 可 
以 看 一 下 还 有 哪些 修改 可 以 做 。 


现在 widget 程序 的 文件 系统 结构 为 : 


/application 目录 
/routes - 根 目 录 controller 
/controllers - RW controllers 
/public- 静态 文件 
/widgets 
/views- 模板 文件 
/widgets 


routes 子 目录 提供 了 高 级 别 〈( 非 对 象 层 面 ) 的 功能 。 命 名 并 不 表意 ， 所 以 重 命名 为 
main。 这 导致 对 app.js 文件 做 出 一 些小 的 修改 : 
// 高 级 别 


app.get('/', main.index) ; 
app.get('/stats', main.stats); 


接 下 来 ， 我 添加 了 一 个 model FAR. HK controller 的 代码 放 在 controllers F A 
录 中 一 样 ，MongoDB model 的 定义 存储 在 这 个 model 子 目 录 中 。 现 在 目录 结 
构 是 : 
/application BX 

/main- 根 目 录 controller 

/controllers - 对 和 象 的 controllers 

/public - 静态 文件 

/widgets 
/views - 模板 文件 


/widgets 


下 一 个 需要 做 的 修改 与 数据 结构 有 关系 。 目 前 程序 的 主键 为 ID 字段 ， 由 系统 生成 
但 是 用 户 可 以 通过 路 由 系统 访问 。 显 示 一 个 widget 的 URL 如 下 所 示 : 


http://localhost:3000/widgets/1 
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这 是 个 一 般 化 的 做 法 。 一 个 很 流行 的 内 容 管理 系统 (CMD ) Drupal， 除 非 用 户 使 用 
URL 重 定向 模块 ， 也 使 这 种 实现 方式 访问 Drupal 市 点 (故事 ，stories ) 和 用 户 : 


http://burningbird.net/node/78 


问题 在 于 MongoDB 为 每 个 对 象 生成 了 唯一 标识 符 并 使 用 了 路 由 无 法 识别 的 形式 。 
有 一 种 变通 的 方案 ， 要 求 创 建 另 一 个 collection 包含 一 个 id， 用 于 替换 系统 生成 标 
示 符 ， 但 是 实现 过 程 很 丑陋 ， 与 MongoDB 的 底层 结构 相反 ， 而 且 Mongoose 也 不 
会 使 用 这 种 方式 。 


Widget 对 象 中 的 title 字段 是 唯一 的 ， 但 是 包含 空格 和 字符 ， 使 它 无 法 作为 URL. 
所 以 ， 我 们 定义 了 一 个 新 的 字段 sn， 作 为 产品 的 序列 化 数字 。 当 创建 一 个 新 的 
widget 对 象 的 时 候 ， 用 户 可 以 任意 制定 一 个 系列 号 给 该 对 象 ， 之 后 我 们 可 以 用 这 
个 序列 号 访问 该 对 象 。 例 如 ， 一 个 widget 的 序列 号 为 1AIA， 可 以 通过 下 列 url 
访问 : 


http://localhost:3000/widgets/1Al1A 


从 程序 角度 来 看 ， 新 的 数据 结构 为 : 


sn:string 
title:string 
desc:string 
price:number 


这 部 分 的 修改 会 导致 用 户 接口 的 一 些 修 改 , 但 是 这 些 修改 是 值得 的 。Jade 模板 有 很 
小 的 地 方 需 要 修改 : 只 需要 将 id 替换 为 sn ， 为 表单 添加 一 个 放 序 列 号 的 字段 。 
提示 

为 了 避免 重复 大 段 代码 来 显示 这 些小 的 修改 ， 我 将 例子 都 放 在 O’Reily 
中 本 书 的 目录 页 : http://oreilly.com/catalog/9781449323073。 在 第 12 
章 目 录 下 你 会 找到 所 有 最 新 的 widget 程序 文件 。 


更 重要 一 些 的 修改 是 对 widget.js 文件 中 controller 的 代码 修改 。 该 文件 的 修改 ， 以 
及 其 他 与 MongoDB 后 台 有 关 的 内 容 将 在 下 一 节 介 绍 。 





10.4 添加 MongoDB 后 台 


第 一 个 修改 是 添加 MongoDB 数据 库 的 连接 ， 添 加 在 app.js 文件 中 ， 这 样 对 数据 的 
连接 存在 于 程序 的 整个 生命 周期 。 
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首先 ， 在 该 文件 中 引入 Mongoose: 


var mongoose = require('mongoose'); 
建立 数据 库 连 接 : 


/ /MongoDB 
mongoose.connect ('mongodb://127.0.0.1/WidgetDB') ; 


mongoose.connection.on('open',’ function() { 
console.log('Connected to Mongoose'); 


pa 
注意 到 MongoDB 的 URI， 指 定 的 数据 库 被 当做 URI 的 最 后 一 部 分 。 
这 个 修改 和 之 前 提 到 的 将 routes 转换 为 main 的 修改 对 app.js 都 是 必需 的 修改 。 
下 一 个 需要 修改 maproutecontrollerjs。 路 由 中 使 用 id 的 部 分 需要 替换 为 sn ， 修 改 
后 的 路 由 如 下 段 代码 所 示 : 


// show 
app.get( prefix + '/:sn', prefixObj.show) ; 


// edit 
app.get( prefix + '/:sn/edit', prefixObj.edit); 


// update 
app.put( prefix + '/:sn', prefixObj.update) ; 


//destroy 
app.del( prefix + '/:sn', prefixObj.destroy) ; 


如 果 不 做 这 个 修改 ，controller 代码 期 望 得 到 sn 作为 参数 ， 但 实际 得 到 的 是 ido 


下 面 需要 添加 一 段 代 码 而 不 是 修改 。 在 models 子 目 录 中 ， 创 建 一 个 新 的 文件 
widgets.js, 定义 为 widget model. 为 了 使 model 在 模块 外 可 以 访问 , 需要 暴露 给 外 部 ， 
如 示例 10-4 所 示 。 


示例 10-4 新 的 widget model 定义 
var mongoose = require('mongoose'); 


var Schema = mongoose.Schema 
, ObjectId = Schema.ObjectId; 


// 创建 Widget model 

var Widget = new Schema ({ 
sn:{type:String, require:true, trim:true, unique:true}, 
name:{type:String, required:true, trim:true}, 
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desc:String, 
price:Number 


})3 


module.exports = mongoose.model('Widget', Widget); 


最 后 需要 做 的 是 对 widget controller 代码 的 修改 ,我 们 需要 使 用 Mongoose, 将 内 存 
中 的 数据 存储 到 MongoDB。 尽 管 这 部 分 修改 对 程序 来 说 很 重要 ， 但 是 代码 本 身 的 
修改 并 不 难 。 只 是 一 些小 的 修改 ， 类 似 于 将 id HON sn 之 类 的 。 示 例 10-5 包含 了 widget 
controller 代码 的 全 部 内 容 。 


示例 10-5 修改 后 的 widget controller 


var Widget = require('../models/widget.js'); 


// i /widgets/ BAA widgets 
exports.index = function (req, res) { 
Widget.find({}, function (err, docs) { 
console.log(docs) ; 
res.render('widgets/index', {title:'Widgets', widgets:docs}); 
b); 
bi 


// display new widget form 


exports.new = function (req, res) { 
console.log(req.url); 
var filePath = require('path').normalize(_dirname + 


"/../public/widgets/new.htmL") ; 
res.sendfile(filePath); 


}; 


// 添加 widget 


exports.create = function (req, res) { 


var widget = { 
sn:req.body.widgetsn, 
name:req.body.widgetname, 
price:parseFloat (req.body.widgetprice), 
desc: req.body.widgetdesc}; 


var widgetObj = new Widget (widget); 


widgetObj.save(function (err, data) { 
if (err) { 
res.send(err); 
} else { 
console.log (data); 
res.render ('widgets/added', {title: 'Widget Added', widget: widget}) ; 
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} 
}); 
}; 
// 显示 widget 
exports.show = function (req, res) { 
var sn = req.params.sn; 
Widget.findOne({sn:sn}, function (err, 


if (err) 
res.send('There is no widget with sn of ' 


doc) { 
+ sn); 


else 
res.render ('widgets/show', 


}); 


{title:'Show Widget', widget:doc}); 


}; 


// 删除 widget 


exports.destroy = function (req, res) 1 
var sn = req.params.sn; 


Widget.remove({sn:sn}, function (err) { 


if (err) { 


res.send('There is no widget with sn of + sn); 
} else { 
console.log ('deleted ' + sn); 
res.send('deleted ' + sn); 
} 
}); 
}; 
// 显示 edit form 
exports.edit = function (req, res) { 
var sn = req.params.sn; 
Widget.findOne({sn:sn}, function (err, doc) { 
console.log (doc) ; 
if (err) 
' + sn); 


res.send('There is no widget with sn of 


else 


res.render('widgets/edit', {title:'Edit Widget', widget:doc}); 


}); 
J3 


// 更 新 widget 


exports.update = function (req, res) { 
var sn = regq.params.sn; 
var widget = { 
sn:req.body.widgetsn, 
name:regq.body.widgetname, 
price:parseFloat (req.body.widgetprice), 
desc:req.body.widgetdesc}; 


Widget.update({sn:sn}, widget, function (err) { 
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if (err) 
res.send('Problem occured with update' + err) 
else 
res.render ('widgets/added', {title:'Widget Edited', widget:widget}) 
bie 
be 


现在 widget FEF Ge AR a] PRATER, MAN SSR ERP ALK So # 
个 程序 的 建立 在 为 对 现 有 稳定 的 程序 组 件 影响 最 小 情况 下 添加 新 的 数据 支持 。 


Wa 提示 
本 章 中 的 widget 应 用 程序 例子 是 在 前 一 章 的 基础 上 完成 的 。 这 意味 着 
à 除了 MongoDB 之 外 ， 你 需要 局 动 Redis 服务 器 来 使 程序 正常 工作 。 
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第 11 章 


Node 与 关系 型 数据 库 


在 传统 的 Web 开发 中 ， 关 系 型 数据 库 是 最 流行 的 数据 存储 手段 。Node 却 没有 遵循 
这 个 模式 ， 或 许 因为 Node 应 用 程序 本 身 的 特性 ， 也 或 许 是 因为 很 多 开发 人 员 并 不 
愿意 在 Node 中 使 用 这 些 传 统 技术 。 相 比 关系 型 数据 库 来 说 ，Node 对 类 似 于 Redis 
和 MongoDB 这 样 的 数据 存储 系统 的 支持 更 多 一 些 。 


如 果 与 PHP 和 Python 等 语言 对 关系 型 数据 库 的 支持 比较 的 话 , Node 提供 的 关系 型 数据 
库 支持 模块 并 不 是 非常 完整 。 在 我 看 来 ， 这 些 模块 其 至 还 没有 到 达 产 品 化 的 程度 。 


不 过 ,从 积极 的 一 面 看， 这些 支持 关系 型 数据 库 的 模块 还 是 相当 易 用 的 。 在 这 一 章 
中 ， 我 会 通过 两 种 不 同 的 方法 来 将 关系 型 数据 库 MySQL 整合 到 我 们 的 Node 应 用 
程序 中 。 一 种 方法 是 使 用 mysql (node-mysql ), 它 是 一 个 较为 流行 的 JavaScriptMySQL 
客户 端 ; 另 一 种 方法 是 使 用 db-mysql， 它 是 node-db ( Node 尝试 构建 的 一 个 通用 数 
据 库 引擎 ) 的 一 部 分 ， 并 是 使 用 C++ 编写 的 。 


这 两 个 模块 目前 都 不 支持 事务 操作 。 但 是 ， 通 过 使 用 mysql-series 模块 ， 我 们 可 以 为 
node-mysql 添加 类 似 的 功能 ， 本 章 会 有 一 个 简单 的 演示 。 男 外 ， 我 们 还 会 对 Sequelize 
做 个 简要 介绍 ， 它 是 一 个 基于 MySQL 数据 库 的 ORM (对象 一 关系 映射 ) 库 。 


关系 型 数据 库 有 很 多 种 ， 包 括 SQL Server. Oracle 以 及 SQLite 等 。 我 选择 使 用 
MySQL, 是 因为 它 能 支持 Windows 和 Unix HSE, 对 于 非 商 业 用 途 它 是 免费 的 , 并 
且 它 也 是 最 普遍 的 被 大 多 数 应 用 程序 所 使 用 的 数据 库 。 另 外 ，Node 关系 型 数据 库 
模块 对 它 的 支持 也 是 最 多 的 。 


在 本 章 中 ， 我 们 使 用 名 为 nodetest2 的 数据 库 进行 所 有 测试 ， 表 结构 如 下 : 


id - int(11), primary key, not null, autoincrement 
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title - varchar(255), unique key, not null 
text - text, nulls allowed 
created - datetime, nulls allowed 


11.1 db-mysql AT] 


在 使 用 db-mysql 之 前 ， 我 要 先 安装 MySQLeclient 库 。 你 可 以 在 http://nodejsdb.org/ 
db-mysql/ 找 到 安装 包 和 安装 说 明 。 


当 配 置 好 上 述 环境 后 ， 就 可 以 使 用 npm KZA DB-mysql T: 


npm install db-mysql 


db-mysql 模块 提供 了 两 个 类 来 支持 与 MySQL 数据 库 的 交互 。 第 一 个 是 database 类 ， 
可 以 使 用 它 来 建立 或 断 开 数据 库 连 接 ， 查 询 操作 也 需要 基于 它 来 进行 。 第 二 个 是 
query 类 ， 当 我 们 对 数据 库 对 象 做 查询 操作 时 就 会 用 到 。 使 用 query 类 来 创建 并 执 
行 查询 操作 ， 有 两 种 方式 : 一 种 是 使 用 方法 链 ， 每 个 方法 描述 了 该 查询 操作 的 一 部 
分 信息 ; 另 一 种 则 是 直接 使 用 SQL 查询 字符 串 。 可 见 db-mysql 的 使 用 是 非常 灵 
活 的 。 

所 有 方法 的 最 后 一 个 参数 都 是 一 个 回调 陋 数 , 查询 结果 以 及 任何 可 能 的 错误 信息 都 
会 传递 给 该 回调 函数 。 你 可 以 使 用 舱 套 回调 或 EventEmitter 事件 机 制 来 将 多 个 操作 
步骤 衔接 起 来 ， 以 便 处 理 错误 信息 或 者 对 执行 数据 库 命令 所 得 到 的 结果 进行 处 理 。 


当 创 建 与 MySQL 数据 库 的 连接 时 ， 你 还 可 以 使 用 一 些 可 选 参数 。 但 必须 提供 的 参 
数 包 括 : 主机 名 (hostname ) 或 端口 ( port ) KERF (socket) HPZ (user), %4 
( password ) 以 及 数据 库 名 称 〈database )。 
var db = new mysql.Database ({ 
hostname: 'localhost', 
aes EA 


database: 'databasenm' 


b)3 
可 选 参数 的 细节 信息 可 以 参考 db-mysql 文档 以 及 MySQL 文档 。 
11.1.1 查询 字符 串 和 方法 链 


为 了 演示 db-mysql 的 灵活 性 ， 示 例 11-1 应 用 程序 在 连接 到 数据 库 后 ， 执 行 了 两 次 
相同 的 查询 操作 : 第 一 次 使 用 query 类 的 方法 链 ， 第 二 次 使 用 查询 字符 串 。 第 一 个 
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查询 操作 使 用 了 一 个 藤 套 回调 也 数 来 处 理 查 询 结 果 , 而 第 二 个 则 监听 succes 和 error 
事件 并 做 出 啊 应 。 无 论 如 何 ， 在 这 两 种 情况 下 返回 的 查询 结果 都 是 rows 对 象 ， 该 
对 象 包含 了 一 个 可 以 描述 查询 结果 中 每 行 数据 的 对 象 数组 。 
示例 11-1 使 用 两 种 不 同 的 查询 方式 展示 db-mysqd| 的 灵活 性 

var mysql = require('db-mysql'); 





// define database connection 
var db = new mysql.Database({ 
hostname: ‘localhost’, 

user: ‘username’, 
password: “USserpass ， 
database: 'databasenm' 


D 


// connect 
db.connect(); 


db.on('error', function(error) { 
console.log("CONNECTION ERROR: ”+ error); 
})3 


// database connected 
db.on('ready', function(server) { 


// query using chained methods and nested callback 
this.query() 

.select('*') 

.from('nodetest2' ) 

.Where( id = 1') 

.execute(function(error, rows, columns) { 

if (error) { 
return console. log('ERROR: 


+ error); 


console. log(rows); 
console. log(columns) ; 


})3 


// query using direct query string and event 
var qry = this.query(); 


qry.execute('select * from nodetest2 where id = 1'); 


qry.on('success', function(rows, columns) { 
console.log(rows); // print out returned rows 
console.log(columns); // print out returns columns 

}); 

gry.on('error', function(error) { 

console.log('Error: ' + error); 

}); 

})5 


当 与 数据 库 的 连接 被 成 功 建立 时 ，database 对 象 会 触发 一 个 ready 事件 ; 如 果 发 生 
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错误 ， 则 触发 一 个 error 事件 。ready 事件 的 回调 师 数 参数 中 包含 了 一 个 server 对 象 ， 
该 对 象 具 有 以 下 属性 : 


hostname 
数据 库 主机 名 。 
user 
建立 数据 库 连 接 所 使 用 的 用 户 名 。 
database 
连接 到 的 数据 库 。 
version 
服务 此 软件 版 本 。 


在 示例 程序 的 第 一 次 查询 操作 中 , 我 们 使 用 了 函数 链 来 构建 查询 操作 。 下 面 列 出 了 
你 可 以 使 用 的 SQL 查询 链 方法 : 


select 

包含 查询 的 选择 标准 ( 如 列 名 清单 或 使 用 星 号 * 表 示 所 有 列 ) 或 选择 字符 串 。 
from 

包含 一 组 数据 库 表 名 或 from 声明 所 包含 的 字符 串 。 
join 


join 子 句 包含 一 个 可 选 对 象 ， 可 以 用 来 指定 该 操作 的 具体 信息 ,被 用 来 连接 的 
表 名 ， 表 的 别名 (如 有 )， 连 接 条 件 (如 有 )， 以 及 是 否 转 义 表 名 及 其 别名 CR 
认为 true )。 


where 
条 件 语句 ， 其 中 可 能 包含 占 位 符 和 用 and 或 or 条 件 连接 起 来 的 方法 。 


order 


追加 一 个 ORDER BY 子 句 。 
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limit 
追加 一 个 LIMIT 子 句 。 
add 
添加 一 个 通用 子 句 ， 例 如 UNION. 


方法 链 提供 了 更 加 通用 的 方法 来 为 不 同 的 数据 库 执 行 相 同 的 SQL 语句 操作 。 目前 ， 
Node.js 的 数据 库 驱 动 程序 支持 MySQL (db-mysql ) 和 Drizzle ( db-drizzle )。 方 法 
链 通 过 提供 统一 的 方法 调用 接口 , 屏蔽 了 两 者 的 不 同 。 方法 链 还 可 以 自动 处 理 并 转 
X SQL 语句 中 的 数据 ， 使 得 查询 操作 符合 数据 库 的 安全 要 求 。 否 则 ， 如 果 下 接 使 
用 查询 语句 ， 你 就 必须 使 用 query.escape 方法 来 正确 地 转 义 SQL 语句 。 


如 果 查 询 操作 成 功 ，query 对 象 会 触发 一 个 success 事件 ， 如 果 失 败 则 触发 一 个 error 
事件 。 另 外 在 得 到 每 一 行 数据 时 ，each 事件 都 会 被 触发 。 当 执行 一 次 查询 操作 后 ， 
对 应 于 success 事件 的 回调 函数 参数 中 会 包含 rows 对 象 以 及 columns 对 象 。rows 
对 象 包含 了 多 个 row 对 象 , 而 每 一 个 row 对 象 也 是 一 个 数组 , 每 个 数组 元 素 包 含 一 
个 名 / 值 对 (name/value pairs ) 对 象 。colums 对 象 则 描述 了 查询 结果 的 列 信息 ， 每 
个 column 对 象 包含 了 列 名 和 数据 类 型 。 如 果 本 例 中 的 测试 表格 包含 id title, text 
和 created FMA, rows 对 象 的 内 容 看 起 来 会 像 
{ id: 1, 
title: 'this is a nice title', 


text: ‘this is a nice text', 
created: Mon, 16 Aug 2010 09:00:23 GMT } 


而 列 对 象 看 起 来 像 这 样 : 


[ name: ‘id', type: 2 }, 


name: 'title', type: 0 }, 
name: 'text', type: 1 }, 
name: 'created', type: 6 } | 


如 果 是 执行 更 新 、 删 除 或 者 插入 等 查询 操作 后 的 success 事件 ， 对 应 的 回调 函数 会 
使 用 result 对 象 作 为 其 参数 。 关 于 该 对 象 的 更 多 的 细 证 将 在 下 一 节 中 做 介绍 。 


虽然 可 以 使 用 不 同 的 方法 来 处 理 查 询 操 作 , 但 它们 都 必须 在 数据 库 连 接 成 功 建立 后 
进行 。 由 于 db-mysql 是 Node 提供 的 一 项 功能 ， 因 此 相关 的 方法 都 是 异步 的 。 如 果 
你 试图 在 数据 库 连 接 回调 函数 之 外 做 query 操作 ， 是 不 会 成 功 的 ， 因 为 那 时 数据 库 
连接 还 未 建立 起 来 。 


232 第 11 章 


11.1.2 使 用 查询 字符 串 更 新 数据 库 
如 前 所 述 , db-mysql 模块 提供 了 两 种 不 同 的 方式 来 更 新 关系 型 数据 库 中 的 数据 : 使 
用 查询 字符 串 ， 或 使 用 方法 链 。 现 在 我 们 来 看 看 查询 字符 串 的 使 用 。 


当 使 用 查询 字符 串 时 ， 你 可 以 直接 使 用 MySQL 客户 端 所 支持 的 SQL 语句 : 


qry.execute ('update nodetest2 set title = "This is a better title" where 
id = LF]? 


或 者 你 也 可 以 使 用 占 位 符 : 


qry.execute ('update nodetest2 set title=? where id=?',|["This was abetter 
title", 1]); 


占 位 符 可 以 在 查询 字符 串 或 方法 链 中 使 用 。 占 位 符 是 一 种 提前 创建 查询 语句 的 方 
去， 你 可 以 在 使 用 时 再 用 任何 你 需要 的 值 蔡 代 占 位 符 。 你 可 以 在 字符 串 中 使 用 问号 
FE (2) 来 表示 占 位 符 ， 然 后 在 使 用 该 字符 串 的 方法 调用 中 以 数组 的 方式 为 多 个 占 
位 符 赋值 ， 而 这 个 数组 一 般 作为 该 方法 的 第 二 个 参数 传 入 。 


在 数据 库 上 执行 操作 后 的 结果 会 作为 success 事件 回调 函数 的 参数 。 在 示例 11-2 中 ， 
我 们 为 test 数据 库 中 插入 了 一 行 新 数据 。 请 注意 ， 程 序 使 用 了 MySQL 的 NOW PK 
数 来 将 created 字段 的 值 设置 为 当前 时 间 。 当 使 用 一 个 MySQL 函数 时 ， 你 需要 把 
它 直 接 写 进 查 询 字 符 串 ， 而 不 能 使 用 占 位 符 。 


示例 11-2 在 查询 字符 串 中 使 用 占 位 符 
var mysql = require('db-mysql'); 


// define database connection 
var db = new mysql.Database({ 
hostname: ‘localhost’, 

user: ‘username’, 
password: ‘userpass', 
database: '‘databasenm' 


j); 


// connect 
db.connect(); 


db.on('error', function(error) { 
console. log("CONNECTION ERROR: ”+ error); 
; 

// database connected 


db.on('ready', function(server) { 


// query using direct query string and event 
var qry = this.query(); 
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qry.execute('insert into nodetest2 (title, text, created) values(?,?,NOW())', 
['Third Entry','Third entry in series']); 


qry.on('success', function(result) { 
console. log(result); 


3 


qry.on('error', function(error) { 
console.log('Error: ' + error); 


J 


})3 
如 果 操 作成 功 ， 操 作 结果 将 以 参数 的 形式 传递 给 回调 函数 并 包含 以 下 内 容 : 
{ id: 3, affected: 1, warning: 0 } 


id 是 生成 的 行 标 识 符 ，affected 属性 表示 受 影响 的 行 数 (1), WR warning 显示 本 
次 查询 操作 所 生成 的 警告 信息 数量 ( 这 里 为 0 )。 


与 上 述 创建 新 数据 条 目的 做 法 一 样 ， 当 需要 更 新 或 删除 数据 信息 时 也 可 以 直接 使 
用 SQL 语句 ， 或 者 使 用 占 位 符 。 在 示例 11-3 实现 的 程序 中 ， 我 们 为 test 数据 库 
添加 了 一 条 新 记录 ， 然 后 更 新 标题 字段 ， 最 后 删除 该 记录 。 你 会 注意 到 ， 不 同 的 
操作 使 用 了 不 同 的 query 对 象 ， 不 过 你 也 可 以 为 同一 个 query 对 象 传递 不 同 的 参 
数 并 多 次 运行 它 。 在 insert 语句 中 我 使 用 了 4 个 占 位 符 ， 如 果 只 为 其 提供 两 个 参 
数 ， 那 么 程序 就 会 报错 。 另 外 ， 该 示例 程序 仍然 使 用 的 是 髋 套 回 调 ， 而 没有 使 用 
事件 捕获 。 


示例 11-3 使 用 内 套 回 调 实 现 插 入 ， 更 新 和 删除 记录 
var mysql = require('db-mysql'); 


// define database connection 
var db = new mysql.Database({ 
hostname: ‘localhost’, 

user: ‘username’, 
password: ‘password’, 
database: 'databasenm' 


})5 


// connect 
db.connect(); 


db.on('error', function(error) { 
console. log("CONNECTION ERROR: ”+ error); 
}); 


// database connected 
db.on('ready', function(server) { 


// query using direct query string and nested callbacks 
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var qry = this.query(); 


qry.execute('insert into nodetest2 (title, text,created) values(?,?,NOW())’, 
[' Fourth Entry','Fourth entry in series'], function(err,result) { 
if (err) { 
console. log(err); 
} else { 
console. log(result) ; 


var qry2 = db.query(); 
qry2.execute('update nodetest2 set title = ? where id = ?， 
['Better title',4], function(err,result) { 
if(err) { 
console. log(err); 
} else { 
console. log(result) ; 
var qry3 = db.query(); 
qry3.execute('delete from nodetest2 where id = ?',[4], 
function(err, result) { 


if(err) { 
console. log(err); 
} else { 
console. log(result); 
} 
}); 
} 
}); 
} 
})5 


在 本 例 你 可 能 会 注意 到 , 如 果 任 何 地 方 发 生 错 误 , 我 们 是 没有 办 法 回 深 已 经 执行 的 
SQL 语句 的 。 目 前 来 说 ，db-mysql 还 不 支持 事务 管理 功能 ， 如 果 需 要 确保 数据 库 
的 一 臻 性， 你 必须 自己 在 应 用 程序 中 实现 它 。 你 可 以 在 每 个 SQL 语句 执行 之 后 的 
错误 检查 代码 中 对 之 前 成 功 执行 的 SQL 语句 进行 回 滚 操作 。 但 这 并 不 是 一 个 理想 
的 解决 方法 ， 而 且 还 必须 谨慎 使 用 自动 递增 字段 。 


a. 提示 
在 另 一 个 模块 一 一 mysql-queues 中 实现 了 一 种 类 似 事务 的 功能 ， 我 将 
S 在 本 章节 的 后 续 部 分 介绍 它 。 


11.1.3 ”使 用 方法 链 更 新 数据 库 

db-mysql 为 数据 库 的 插入 、 更 新 和 删除 操作 提供 了 独立 的 方法 ， 包 括 : insert, update 
以 及 delete。update 和 delete 方法 可 以 结合 where 方法 使 用 ， 而 where 方法 可 以 使 
FA and 和 or 方法 并 按 顺 序 处 理 它们 。update 方 法 还 可 以 使 用 男 一 个 set 方 法 来 为 SQL 
指定 需要 更 新 的 值 。 
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示例 11-4 完成 了 与 示例 11-3 相同 的 功能 ， 但 它 使 用 了 方法 链 来 实现 插 人 和 更 新 记 
录 。 它 没有 使 用 delete 方法 ， 因 为 在 我 写 这 本 书 时 ，delete 方法 还 不 能 正常 工作 。 


示例 11-4 使 用 方法 链 插入 一 个 新 的 记录 ， 然 后 更 新 它 


var mysql = require('db-mysql'); 


// define database connection 
var db = new mysql.Database({ 
hostname: ‘localhost’, 

user: ‘username’, 
password: ‘password’, 
database: '‘databasenm' 


W; 


// connect 
db.connect(); 


db.on('error', function(error) { 
console. log("CONNECTION ERROR: ”+ error); 


h; 


// database connected 
db.on('ready', function(server) { 


// query using direct query string and nested callbacks 
var qry = this.query(); 
qry.insert('nodetest2',['title’,'text','created'], 
['Fourth Entry’, ‘Fourth entry in series', 'NOW()']) 
-execute(function(err,result) { 
if (err) { 
console. log(err) ; 
} else { 
console. log(result); 


var qry2 = db.query(); 

qry2.update('nodetest2') 
.set({title: “Better title'}) 
.where('id = ?',[4]) 
.execute(function(err, result) { 


if(err) { 
console. log(err); 
} else { 
console. log(result) ; 
} 
}); 
} 
}); 


当 你 需要 从 应 用 程序 中 获取 信息 然后 进行 SQL 查询 操作 , 或 者 当 你 的 应 用 程序 需 
要 支持 多 种 数据 库 时 ， eet 很 方便 , 但 是 ,我 个 人 并 不 喜欢 使 用 方 
法 链 。 
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11.2 ”使 用 node-mysdl 实现 本 地 MySQL 访问 


与 db-mysql 不 同 , 你 不 需要 安装 MySQL 客户 端 软件 就 可 以 使 用 它 。 你 只 需要 安装 
该 模块 就 行 : 
npm install mysql 


它 的 使 用 也 很 简单 。 创 建 一 个 客户 端 ， 然 后 连接 到 MySQL 数据 库 中 ,选择 要 使 用 
的 数据 库 ， 再 通过 query 方法 完成 所 有 的 数据 库 操作 。guery 方法 的 最 后 一 个 参数 
是 一 个 回调 函数 , 通过 它 能 够 取得 操作 的 处 理 结果 。 如 果 不 使 用 回调 函数 ,还 可 以 
通过 监听 事件 的 方式 来 确定 处 理 过 程 何 时 完成 。 


11.2.1 使 用 node-mysal 做 基本 的 CRUD 操作 

正如 刚才 所 说 的 ， 使 用 node-mysql API 是 非常 简单 的 : 创建 客户 端 ， 设 置 数据 库 ， 
并 通过 客户 问 发 送 SQL 查询 语 铅 。 回 调 函数 是 可 选 的 ， 并 且 有 一 些 基本 的 事件 支 
持 。 当 你 使 用 回调 函数 时 , 回调 函数 的 参数 通常 包含 error 和 result, 当 使 用 SELECT 
查询 语句 时 ， 回 调 果 数 中 还 会 包含 一 个 fields 参数 。 


示例 11-5 演示 如 何 使 用 node-mysql 连接 数据 库 ， 创 建 一 条 新 记录 并 更 新 它 ， 最 后 
再 删除 它 。 这 是 个 很 简单 的 例子 ， 但 却 能 描述 node-mysql 支持 的 所 有 功能 。 


示例 11-5 使 用 node-mysql 实现 CRUD 操作 


var mysql = require('mysql'); 


var client = mysql.createClient({ 
user: ‘username’, 
password: ‘password’ 


client.query('USE databasenm' ) ; 


// create 
client.query('INSERT INTO nodetest2 ' + 
"SET title = ?, text = ?, created = NOW()', 
['A seventh item’, 'This is a seventh item'], function(err, result) { 
if (err) { 
console. log(err); 
} else { 
var id = result.insertId; 
console. log(result.insertId) ; 


// update 
client.query('UPDATE nodetest2 SET ' + 
‘title = ? WHERE ID = ?', ['New title’, id], function (err, result) { 
if (err) { 
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console. log(err); 
} else { 
console. log(result.affectedRows) ; 


// delete 
client.query('DELETE FROM nodetest2 WHERE id = ?', 
[id], function(err, result) { 
if(err) { 
console. log(err); 
} else { 


console. log(result.affectedRows) ; 


// named fenction rather than nested callback 
getData(); 


// retrieve data 
function getData() { 
client.query('SELECT * FROM nodetest2 ORDER BY id’, function(err, result,fields) { 
if(err) { 
console. log(err); 
} else { 
console. log(result) ; 
console. log(fields); 


} 
client.end(); 
}); 

} 
正如 我 们 所 期 望 的 , 查询 结果 被 保存 到 了 -一 个 对 象 数组 中 , 每 个 数组 元 素 表示 一 行 
数据 。 下 面 是 该 对 象 数组 的 内 容 示 例 ( 只 显示 了 第 一 行 数据 的 内 容 ): 


Es ML 
title: 'This was a better title', 
text: 'this is a nice text', 


created: Mon, 16 Aug 2010 15:00:23 GMT }, 
» ] 


另外 ， 回 调 函 数 同 时 还 包含 了 fields 参数 ， 不 过 它 描述 信息 的 格式 与 其 他 模块 不 大 
相同 。 我 们 得 到 的 不 是 一 个 对 象 数组 ,而 是 一 个 对 象 。 该 对 象 的 属性 名 称 和 数据 库 
表格 的 字段 一 一 对 应 , 而 属性 值 则 是 一 个 描述 了 字段 信息 的 对 象 。 由 于 整个 对 象 的 
言 息 量 比较 大 ， 因 此 这 里 我 只 展示 有 关 第 一 个 字段 id 的 内 容 : 

lidi 


{ length: 53, 
received: 53, 
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number: 2, 

type: 4, 

catalog: ‘def', 

db: 'nodetest2', 
table: 'nodetest2', 


OriginalTable: 'nodetest2', 
name: ‘id', 
OriginalName: 'id', 


charsetNumber: 63, 
fieldLength: 11, 
fieldType: 3, 
flags: 16899, 
decimals: 0 }, ... 


该 模块 不 文 持 SQL HARE, ERA IFS. t FERIE mysql-queues, 
它 是 唯一 能 提供 类 似 事务 支持 的 库 。 


11.2.2 MySQL 事务 与 mysql-queues 


mysql-queues 模块 对 node-mysql 进行 了 包装 , 并 对 多 重 查询 以 及 数据 库 事务 提供 了 
支持 。 当 使 用 它 时 ， 可 能 会 觉得 有 点 奇怪 ， 看 上 去 它 似乎 并 没有 提供 对 异步 的 支持 ， 
但 实际 并 非 如 此 。 


通常 情况 下 ， 为 了 确保 完成 异步 功能 ， 你 可 以 使 用 藤 套 回调 、 命 名 了 国 数 ,或 类 似 于 
Async 这 样 的 模块 。 在 示例 11-6 中 ，mysql-queues 控制 执行 流程 ， 确 保 队 列 中 的 所 
有 SQL 语句 都 能 在 最 后 SELECT 被 处 理 前 执行 完成 。 这 些 SQL 语句 按照 如 下 顺序 
依次 完成 处 理 : insert，update， 最 后 是 retrieve。 


示例 11-6 ”使 用 队列 管理 多 个 SQL 语句 的 执行 
var mysql = require('mysql'); 


var queues = require('mysql-queues'); 


// connect to database 

var client = mysql.createClient({ 
user: ‘username’, 
password: ‘password’ 


client.query('USE databasenm') ; 
//associated queues with query 
// using debug 


queues(client, true); 


// create queue 
q = client.createQueue() ; 


// do insert 
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q.query('INSERT INTO nodetest2 (title, text, created) ee: 
"values(?,?,NOW())', 
['Title for 8', 'Text for 8']); 


// update 
q.query('UPDATE nodetest2 SET title = ? WHERE title = ?', 
['New Title for 8','Title for 8']); 


q.execute(); 


// select won't work until previous queries finished 
client.query('SELECT * FROM nodetest2 ORDER BY ID’, function(err, result, fields) { 
if (err) { 
console. log(err); 
} else { 


// should show all records, including newest 
console. log(result); 
client.end(); 
} 
})5 


如 果 需 要 实现 事务 功能 ， 那 么 你 需要 启动 一 个 事务 ， 而 非 队 列 ( queue ) 并且 你 需 
要 在 发 生 错 误 时 调用 rollback 来 执行 回 滚 操作 ， 当 成 功 完成 操作 后 执行 commit 来 
结束 事务 。 同 样 的 ， 当 你 调用 了 事务 对 象 的 execute 方法 后 ， 之 后 所 有 的 查询 操作 
都 会 被 放 和 人 队列 等 待 执行 直到 事务 被 处 理 完毕 。 示 例 11-7 与 示例 11-6 实现 的 功能 
相同 ， 但 却 使 用 了 事务 。 


示例 11-7 使 用 事务 实现 更 可 控 的 SQL 更 新 操作 


var mysql = require('mysql'); 
var queues = require('mysql-queues'); 


// connect to database 

var client = mysql.createClient({ 
user: ‘username’, 
password: ‘password’ 


}); 
client.query('USE databasenm' ); 


//associated queues with query 
// using debug 
queues(client, true); 


// create transaction 

var trans = client.startTransaction(); 

// do insert 

trans.query('INSERT INTO nodetest2 (title, text, created) ' + 
'values(?,?,NOW())', 
['Title for 8', 'Text for 8'], function(err,info) { 


if (err) { 


trans.rollback(); 
} else { 
console. log(info) ; 


// update 
trans.query('UPDATE nodetest2 SET title = ? WHERE title = ?', 
['Better Title for 8','Title for 8'], function(err,info) { 
if(err) { 
trans.rollback(); 
} else { 
console. log(info); 
trans.commit(); 
} 
}); 
} 
}); 


trans.execute(); 


// select won't work until transaction finished 
client.query(' SELECT * FROM nodetest2 ORDER BY ID', function(err, result, fields) { 
if (err) { 
console. log(err); 
} else { 


// should show all records, including newest 
console. log(result) ; 
client.end(); 


} 
AF 


mysql-queues 为 node-mysql 模块 添加 了 两 个 重要 的 组 件 : 

。 支持 多 重 查 询 ， 而 无 需 使 用 舱 套 回调 ; 

。 支持 事务 。 

如 果 你 打算 使 用 node-mysql 的 话 ， 我 强烈 建议 你 也 使 用 mysql-queues。 


11.3 ORM 5 Sequelize 


之 前 提 到 的 所 有 模块 都 为 MySQL AEE EAE F, 但 它们 没有 再 提供 更 高 层 
次 抽象 的 支持 。 而 Sequelize 模块 实现 了 对 ORM 的 支持 ， 尽 管 它 还 不 支持 事务 。 
11.3.1 定义 模型 


要 使 用 Sequelize， 首 先 需 要 定义 模型 。 模 型 表示 了 数据 库 表 和 JavaScript WAZ 
间 的 映射 关系 。 在 前 面 的 示例 程序 中 , 我 们 用 到 了 一 个 简单 的 表格 nodetest2 ， 结 构 
如 下 : 
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id - int(11), primary key, not null 

title - varchar(255), unique key, not null 
text - text, nulls allowed, 

created - datetime, nulls allowed 


我 们 需要 为 每 个 字段 使 用 适当 的 数据 库 标 志 来 创建 这 个 数据 库 表 对 应 的 模型 : 


// define model 
var Nodetest2 = sequelize.define('nodetest2', 
{id : {type: Sequelize.INTEGER, primaryKey: true}, 
title : {type: Sequelize. STRING, allowNull: false, unique: true}, 
text : Sequelize.TEXT, 
created : Sequelize.DATE 
} ) ; 


目前 支持 的 数据 类 型 映射 : 
e Sequellze.STRING =>VARCHAR(255) 
e Sequelize. TEXT => TEXT 
e Sequelize. INTEGER => INTEGER 
e Sequelize. DATE => DATETIME 
e Sequelize. FLOAT => FLOAT 
e Sequelize., BOOLEAN =>TINYINT(1) 
可 以 用 来 进一步 细 化 字段 的 选项 包括 : 
type 

字段 的 数据 类 型 。 
allowNull 

false 表示 不 允许 为 空 ， 默 认为 true。 
unique 

设置 为 true 可 以 防止 写 人 重复 值 ， 默 认为 false。 
primaryKey 

true 表示 设置 为 主键 。 
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autolncrement 
true 表示 为 目 动 递增 字段 。 


如 果 你 正 打算 新 建 一 个 应 用 程序 和 对 应 的 数据 库 的 话 , 那么 在 完成 模型 定义 后 , 你 
就 可 以 直接 通过 运行 syne 方法 来 创建 对 应 的 数据 库 表格 : 

// sync 

Nodetest2.sync().error(function(err) { 


console.log(err); 


})3 


如 果 你 这 么 做 了 ， 你 会 发 现 数据 库 表 和 模型 会 有 一 些 不 同 ， 这 是 由 于 Sequelize 修 
改 了 数据 库 表 。 首 先 ， 表 的 名 称 变 为 nodetest2s MAF nodetest2; 其 次 ， 新 增 了 两 个 
RFK: 


id - int(11), primary key, autoincrement 
title - varchar(255), unique key, nulls not allowed 
text - text, nulls allowed 


created - datetime, nulls allowed 
createdAt - datetime, nulls not allowed 
updatedAt - datetime, nulls not allowed 


由 于 没有 办 法 阻止 Sequelize 对 数据 库 表 做 此 类 修改 ， 因 此 你 要 相应 地 调整 你 
之 前 对 处 理 结果 的 预期 。 作 为 开胃 沫 ， 先 来 删除 created 字段 吧 ， 因 为 你 不 再 
需要 它 了 。 步骤 很 简单 , 先 在 Sequelize 模型 中 删除 该 字段 , 然后 再 次 运行 sync 
方法 : 
// define model 
var Nodetest2 = sequelize.define('nodetest2', 
{id : {type: Sequelize. INTEGER, primaryKey: true}, 
title : {type: Sequelize.STRING, allowNull: false, unique: true}, 
text : Sequelize.TEXT, 
}); 
// sync 
Nodetest2.sync().error(function(err) { 


console.log(err); 


Hé 


现在 ， 你 已 经 拥有 一 个 能 够 描述 模型 的 JavaScript 对 象 了 ， 而 且 还 建立 了 模型 与 数 
据 库 表 的 映射 关系 。 接 下 来 ， 我 们 会 回 数 据 库 表 中 添加 一 些 数据 。 


11.3.2 ORM 风格 的 CRUD 实现 
让 我 们 继续 看 看 使 用 MySQL 数据 库 绑 定 和 使 用 ORM 之 间 的 差异 。 使 用 ORM 
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时 ， 你 无 需 为 新 数据 做 插 人 操作 ， 而 是 要 创建 一 个 新 的 对 象 实例 并 保存 它 。 对 
于 更 新 操作 ， 也 是 同样 的 道理 : 不 再 使 用 SQL 语句 来 完成 更 新 操作 ， 而 是 直接 
修改 对 象 属性 ， 或 者 使 用 updateAttributes 并 传人 需要 修改 的 对 象 属性 。 当 需要 
从 数据 库 中 删除 一 行 数据 时 ， 你 只 需要 访问 对 应 的 对 象 实例 ， 然 后 调用 destroy 
方法 。 


为 了 说 明 所 有 这 些 操作 ， 我 在 示例 11-8 中 实现 了 模型 创建 、 数 据 库 同步 ( 创建 表 ， 
如 果 它 已 经 不 存在 的 话 )、 创 建新 实例 以 及 保存 实例 等 操作 。 在 示例 程序 中 ， 我 们 
首先 创建 了 一 个 新 实例 ， 然 后 对 它 做 了 两 次 更 新 操作 。 而 在 新 添加 的 对 象 被 销毁 前 ， 
我 们 还 检索 并 输出 了 所 有 对 象 内 容 。 


示例 11-8 使 用 Sequelize 实现 CRUD 操作 


var Sequelize = require('sequelize'); 


var sequelize = new Sequelize('databasenm', 
‘username’, ‘password’, 
{ logging: false}); 


// define model 
var Nodetest2 = sequelize.define('nodetest2', 
{id : {type: Sequelize.INTEGER, primaryKey: true}, 
title : {type: Sequelize.STRING, allowNull: false, unique: true}, 
text : Sequelize.TEXT, 
}); 


// sync 
Nodetest2.sync().error(function(err) { 
console.log(err); 


J 


var test = Nodetest2.build( 
{ title: 'New object’, 
text: 'Newest object in the data store'}); 
// save record 
test.save().success(function() { 


// first update 
Nodetest2.find({where : {title: 'New object'}}).success(function(test) { 
test.title = New object title’; 
test.save().error(function(err) { 
console. log(err); 


3 
test.save().success(function() { 


// second update 
Nodetest2.find( 
{where : {title: ‘New object title'}}).success(function(test) { 
test.updateAttributes( 


{title: ‘An even better title'}).success(function() {}); 
test.save().success(function() { 
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// find all 
Nodetest2.findAl1l().success(function(tests) { 
console. log(tests); 


// find new object and destroy 
Nodetest2.find({ where: {title: ‘An even better title'}}). 
success(function(test) { 
test.destroy().on('success', function(info) { 
console.log(info) ; 
})3 
})3 


}); 
t); 


在 输出 findAll 得 到 的 查询 结果 后 ， 对 于 其 所 包含 的 信息 量 你 可 能 会 感到 惊讶 。 
其 实 ， 你 也 可 以 直接 访问 查询 结果 中 的 属性 值 ， 首 先 访 问 数组 元 素 ， 然 后 取得 属 


性 值 : 


tests[0].id; // returns identifier 


查询 结果 所 包含 的 其 他 数据 信息 则 完全 说 明了 ORM 与 关系 型 数据 库 绑 定 的 区 别 。 


下 面 是 查询 结果 的 内 容 示 例 : 


[ { attributes: [ 'id', 'title', 'text', 'createdAt', 'updatedAt' ], 
validators: {}, 
__ factory: 
{ options: [Object], 

name: ‘nodetest2', 
tableName: 'nodetest2s', 
rawAttributes: [Object], 
daoFactoryManager: [Object], 
associations: {}, 
validate: {}, 
autoIncrementField: ‘id’ }, 

__options: 

{ underscored: false, 

hasPrimaryKeys: false, 
timestamps: true, 
paranoid: false, 
instanceMethods: {}, 
classMethods: {}, 
validate: {}, 
freezeTableName: false, 
id: ‘INTEGER NOT NULL auto_increment PRIMARY KEY ， 
title: 'VARCHAR(255) NOT NULL UNIQUE", 
text: 'TEXT', 

createdAt: 'DATETIME NOT NULL’, 

updatedAt: 'DATETIME NOT NULL’ }, 
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id: 14， 

title: 'A second object’, 

text: ‘second’, 

createdAt: Sun, 08 Apr 2012 20:58:54 GMT, 
updatedAt: Sun, 08 Apr 2012 20:58:54 GMT, 
isNewRecord: false },... 


11.3.3 添加 多 个 对 象 
Sequelize 的 异步 特性 在 示例 11-8 中 有 明显 的 体现 。 当 你 不 需要 一 次 性 增加 多 条 数 
据 记 录 时 ， 使 用 筷 套 回调 没有 问题 。 和 否则 ， 使 用 嵌 套 回调 则 会 碰 到 问题 。 


幸运 的 是 ,Sequelize 提供 了 一 种 简单 的 方式 来 链接 多 个 操作 , 这 样 你 就 可 以 做 
一 些 事情 ， 比 如 创建 多 个 对 象 实例 ， 然 后 一 次 性 将 它们 全 部 保存 起 来 。 该 模块 
提供 了 一 个 名 为 chainer 的 helper, PKA) LA FE IM AR A chainer 添加 多 个 
EventEmitter 任务 〈 比如 查询 操作 )， 不 过 在 你 调用 run 之 前 ， 所 有 任务 都 不 会 
被 执行 。 而 调用 run 后 所 有 操作 的 处 理 结果 都 会 被 返回 ， 无 论 操 作 是 成 功 还 是 
失败 。 


示例 11-9 演示 了 如 何 使 用 chainerhelper, 该 示例 程序 首先 创建 了 三 个 对 象 实例 并 保 
存 它们 ， 然 后 运行 了 find All 来 验证 这 些 实例 是 否 被 成 功 保存 。 


示例 11-9 使 用 chainer 简化 多 个 对 象 实例 的 添加 操作 


var Sequelize = require('sequelize'); 


var sequelize = new Sequelize('databasenm', 
‘username’, ‘password’, 
{ logging: false}); 


// define model 
var Nodetest2 = sequelize.define('nodetest2', 
{id : {type: Sequelize. INTEGER, primaryKey: true}, 
title : {type: Sequelize.STRING, allowNull: false, unique: true}, 
text : Sequelize.TEXT, 
H; 


// sync 
Nodetest2.sync().error(function(err) { 
console. log(err); 


var chainer = new Sequelize.Utils.QueryChainer ; 
chainer.add(Nodetest2.create({title: 'A second object',text: 'second'})) 
.add(Nodetest2.create({title: 'A third object’, text: 'third'})); 


chainer.run() 
.error(function(errors) { 
console. log(errors) ; 


}) 
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.success(function() { 
Nodetest2.findAll().success(function(tests) { 
console. log(tests); 


} 
}); 


相 比 之 前 的 代码 , 这 段 代 码 更 简单 ， 也 更 容易 阅读 。 而 且 这 种 方法 更 适合 包含 有 用 
户 界面 或 使 用 了 MVC 的 应 用 程序 。 


Sequelize 模块 的 文档 网 站 上 有 更 多 相关 介绍 , 包括 如 何 处 理 相 关联 的 对 象 ( 数据 库 
表 之 间 的 关联 )。 


11.3.4 ”从 关系 型 到 ORM 

当 使 用 ORM 时 ， 你 需要 牢记 它 有 关 数 据 结构 的 符 干 假设 。 第 一 个 假设 是 : 如 果 模 
型 对 象 的 名 字 为 Widget， 那 么 对 应 的 数据 库 表 名 为 widgets。 另 一 个 假设 是 : 数据 
库 表 的 每 一 行 数据 中 都 包含 了 该 行 数据 的 添加 及 更 新 时 间 。 然而 , 当 需 要 将 一 个 现 
存 的 ,已 经 使 用 了 绑 定 技术 的 数据 库 系统 转换 为 使 用 ORM 时 ,这 两 个 假设 可 能 就 
会 成 为 障碍 (大 多 ORM 实现 都 存在 这 种 问题 )。 


使 用 Sequelize 的 真正 问题 在 于 它 会 复数 化 表 名 ， 不 管 你 愿 不 愿意 。 因 此 ， 如 果 你 
为 某 个 表 定义 模型 时 , Sequelize 会 期 望 将 复数 化 后 的 模型 名 称 作 为 数据 库 表 名 。 即 
使 你 指定 一 个 表 名 ，Sequelize 也 要 将 它 复数 化 。 当 你 使 用 一 个 干净 的 数据 库 时 , 这 
种 操作 没有 任何 问题 ， 它 会 在 调用 sync 的 时 候 自 动 为 你 创建 这 些 表 。 但 是 当 你 使 
用 一 个 现 有 的 关系 数据 库 时 ,这 将 会 是 一 个 问题 。 因 此 ， 如 果 你 不 是 在 构建 一 个 全 
新 系统 的 话 ， 我 强烈 建议 你 不 要 使 用 Sequelize 模块 。 
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图 形 和 HTML5 Video 


Node 提供 了 很 多 使 用 不 同 图 形 程序 和 程序 库 的 机 会 。 作 为 服务 需 疹 技术 ， 你 的 Node 
程序 可 以 使 用 任何 基于 服务 器 的 图 形 软件 ， 比 如 ImageMagick 或 者 GD. JF AINA 
Node 也 是 基于 与 驱动 Chrome 浏览 器 相同 的 JavaScript 引擎, 你 还 可 以 使 用 客户 站 
的 图 形 程序 ， 比 如 Canvas, WebGL 等 等 。 


同时 ，Node 对 现代 浏览 器 支持 的 HTML5 新 的 媒体 元 素 audio 和 video 文件 提供 了 
一 定 支持 。 虽 然 在 直接 使 用 video 和 audio 上 有 所 限制 ， 但 是 在 之 前 的 章节 中 了 解 
到 程序 可 以 提供 这 两 种 类 型 的 文件 。 我们 也 可 以 使 用 一 些 基 于 服务 器 的 技术 ， 比 如 
FFmpeg. 


没有 任何 一 个 关于 Web 图 形 的 章节 不 提 到 PDF 的 。 对 在 网 站 上 使 用 PDF 文档 的 用 
户 来 说 有 个 好 消息 ,我 们 可 以 使 用 一 个 非常 好 的 Node 模块 用 于 生成 PDF， 服 务 天 
上 还 安装 了 很 多 非常 有 用 的 PDF 工具 和 库 。 


我 不 会 详尽 列举 Node 中 每 一 个 图 形 或 者 媒体 实现 和 管理 功能 的 每 种 形式 。 一 个 原 
因 是 我 并 不 熟悉 所 有 的 方式 , 另 一 个 原因 是 有 些 文 持 并 不 完整 , 或 者 该 技术 需要 特 
别 多 资源 。 所 以 , 我 会 关注 在 对 Node 程序 更 有 意义 更 稳定 的 技术 上 : ImageMagick 
基本 的 图 片 管理 ，HTMLS video， 创 建 PDF， 用 Canvas 创建 / 流 化 图 像 。 


12.1 创建 和 使 用 PDF 


操作 系统 、HTML 版 本 、 开 发 技术 , 这些 都 会 有 所 更 改 , 但 是 没有 变化 的 是 无 所 不 
在 的 PDF。 不论 你 创建 什么 类 型 的 程序 、 提 供 什 么 类 型 的 服务 ， 你 都 很 有 可 能 需要 
提供 PDF 文档 服务 。 就 像 谁 说 的 那 句 : PDF 很 帅 。 
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在 Node 程序 中 使 用 PDF 有 很 多 选择 。 一 种 实现 方式 是 使 用 Node 子 进程 访问 操作 
系统 工具 , 比如 PDFToolkit 或 者 Linux 上 的 wkhtmltopdf. 另 一 种 方式 是 使 用 模块 ， 
比如 很 流行 的 PDFKit。 或 者 两 种 混合 使 用 。 


12.1.1 使 用 子 进程 访问 PDF 工具 

尽管 Windows 平台 很 少 有 命令 行 可 以 操作 PDF ,但 对 于 Linux 和 OS X 来 说 还 是 有 
一 些 可 用 的 命令 。 幸 运 的 是 ， 我 使 用 过 的 两 个 一 一 PDF Toolkit 和 wkhtmltopdf， 都 
可 以 在 以 上 三 个 环境 中 安装 。 

Wkhtmltopdf 对 页 面 截屏 


Wkhtmltopdf 使 用 WebKit 泻 染 机 制 将 HTML 转换 为 PDF 文件 , 是 一 种 对 网 站 或 者 
图 片 截屏 的 便捷 方式 。 一 些 网 站 提供 了 将 页 面 内 容 生成 PDF 的 功能 ， 但 是 经 常 在 
生成 的 PDF 中 去 掉 所 有 图 片 。Wkhtmltopdf 工具 可 以 维持 页 面 所 有 的 内 容 和 样式 。 


Wkhtmltopdf Æ OS X 和 Windows 的 安 疫 版 本 ， 对 于 Unix 环境 你 可 以 下 载 源 代码 
自己 build。 如 果 你 在 服务 器 上 运行 程序 ， 你 需要 做 些 修 改 ， 因 为 它 对 X Windows 
的 依赖 。 


为 了 在 我 的 系统 上 (Ubuntu ) 使 用 wkhtmltopdf， 我 需要 安装 支持 这 一 功能 的 库 : 


apt-get install openssl build-essential xorg libssl-dev 


然后 我 需要 安装 xvfb 工具 ， 人 允许 wkhtmltopdf 运行 在 虚拟 的 X server 上 ( 绕 过 对 X 
Windows 依赖 ): 


apt-get install xvfb 


下 一 步 ， 创 建 一 个 shell 脚本 一 一 wkhtmltopdf.sh， 将 wkhtmltopdf GÆ% xvfb 中 。 
代码 行为 : 


xvfb-run -a -s "-screen 0 640x480x16 wkhtmltopdf $* 


将 这 个 shell 脚本 放 在 /usr/bin 目录 下 ， 并 用 chmodatx 改变 文件 权限 。 现 在 ， 可 以 
通过 Node 程序 访问 wkhtmltopdf。 


Wkhtmltopdf 工具 支持 一 系列 选项 ， 但 是 我 只 打算 简单 介绍 从 Node 程序 如 何 使 用 
该 工具 。 在 命令 行 中 ， 下 面 这 行 代码 接收 一 个 链接 到 远程 网 页 的 URL 然后 使 用 所 
有 默认 设置 生成 PDF: 


Wkhtmltopdf.sh http://remoteweb.com/pagel.html pagel.pdf 
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在 Node 中 实现 这 一 过 程 , 需要 使 用 子 进程 。 作 为 扩展 ,程序 需要 接收 输入 的 URL 
和 输出 文件 。 示 例 12-1 显示 了 整个 程序 。 


示例 12-1 简单 的 包含 wkhtmltopdf 的 Node 程序 


var spawn = require('child_process') .spawn; 
// 命令 行 参数 
var url = process.argv[2]; 
var output = process.argv[3]; 
if (url&& output) { 
var wkhtmltopdf = spawn('wkhtmltopdf.sh', [url, output]); 
wkhtmltopdf.stdout.setEncoding('utf8'); 
wkhtmltopdf.stdout.on('data', function (data) { 
console.log (data); 
} ) ; 
wkhtmltopdf.stderr.on('data', function (data) { 
console.log('stderr: ' + data); 
} ) ; 
wkhtmltopdf.on('exit', function (code) { 
console.log('child process exited with code ' + code); 
} ) ; 
} else { 
console.log('You need to provide a URL and output file name'); 


} 


你 一 般 不 会 在 Node 程序 中 单独 使 用 wkhtmltopdf, 但 是 对 于 想 要 提供 创建 网 页 PDF 
功能 的 程序 和 网 站 来 说 这 是 种 很 便捷 的 方式 。 


使 用 PDF Toolkit 访问 PDF 文件 中 的 数据 


PDF Toolkit 或 者 pdfkt， 提 供 了 将 分 解 PDF 文档 或 者 将 多 个 PDF 合并 为 一 个 的 功 
能 ， 同 样 还 可 以 用 于 填写 PDF 表单 ， 加 水 印 ， 旋 转 PDF 文档 ， 压 缩 或 者 解压 ， 修 
改 PDF。MAC 和 Windows 系统 都 有 安装 文件 ， 大 部 分 Unix 系统 只 需要 按照 安装 
说 明 即 可 。 


PDF Toolkit 可 以 通过 Node 的 子 进程 访问 。 以 下 例子 中 的 代码 创建 了 一 个 子 进程 ， 
调用 PDF Toolkit 的 dump data 来 确认 PDF 的 信息 ， 比 如 包含 多 少 页 : 


var spawn = require('child_process') .spawn; 
var pdftk = spawn ('pdftk', [_dirname + '/pdfs/datasheet-node.pdf', 'dump_ 
data']); 
pdftk.stout.on('data', function(data) { 
// 将 结果 转换 为 对 象 
Var array = data.toString().split('\n'); 
var obj = {}; 
array.forEach(function(line) { 
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var tmp = line.split(':'); 
obj [tmp[0]] = tmp[1]; 


} ) ; 
// 输 出 页 面 总 数 
console.log (obj ['NumberOfPages']); 
} ) ; 
pdftk.stderr.on('data', function (data) { 
console.log("stderr: ' + data); 
} ) ; 
pdftk.on('exit', function(code) { 
console.log('child process exited with code' + code); 


} ) 7 
PDF Toolkitdata_dump 返回 结果 如 下 所 示 : 


stdout: InfokKey: Creator 

InfoValue: PrintServer150&#0; 

InfoKey: Title 

InfoValue: &#0; 

InfoKey: Producer 

InfoValue: Corel PDF Engine Version 15.0.0.431 
InfoKey: ModDate 

InfoValue: D:201109142231522 

InfoKey: CreationDate 

InfoValue: D:201109142231522 

PdfIDO: 7fbe73224e44cb152328ed693290b5la 
PdafID1: 7fbe73224e44cb152328ed693290b51la 
NumberOfPages: 3 


这 种 格式 很 容易 转换 为 一 个 易于 访问 个 体 属性 的 对 象 。 


PDF Toolkit 是 一 个 响应 式 工 具 ， 当 你 在 暂停 一 个 网 页 等 待 响应 结束 时 必须 要 小 心 。 
接 下 来 我 们 会 构建 一 个 简单 的 PDF 上 传 工具 ， 来 说 明 如 何 从 Node Web 程序 使 用 
PDF Toolkit， 以 及 如 何 应 对 开销 很 大 的 图 形 处 理 程序 导致 的 时 延 。 


创建 一 个 PDF uploader 和 处 理由 图 像 导 致 的 延 时 


PDF Toolkit 分 解 和 合并 PDF 文档 的 能 力 对 于 允许 用 户 上 传 和 下 载 PDF 的 网 站 来 说 
非常 有 用 , 可 以 提供 对 每 个 PDF 页 面 的 独立 访问 接口 。 考虑 下 Google Docs 或 者 类 
似 Scribd 的 网 站 ， 都 可 以 进行 PDF 的 分 享 。 


这 类 型 程序 的 组 件 包 括 : 
。 一 个 form， 选 择 用 于 上 传 的 PDF TH; 
e Web service ( 网 络 服务 )， 接 收 PDF 文档 ， 初 始 化 PDF 处 理 过 程 ; 
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e THE, BE PDF Toolkit， 将 PDF 文档 分 解 为 独立 的 页 面 ; 
e ”对 用 户 的 啊 应 ， 提 供 上 传 文档 的 链接 和 访问 独立 页 面 的 链接 。 


分 解 PDF 的 组 件 首先 必须 为 分 解 后 产生 的 页 面 创建 目录 以 及 决定 分 解 操作 后 各 页 
面 的 名 字 。 这 就 需要 访问 Node 文件 系统 模块 来 为 分 级 后 的 文件 创建 目录 。 很 明显 ， 
较 大 的 文件 花费 的 时 间 会 比较 长 ， 所 以 不 必 挂 起 页 面 等 待 PDF Toolkit 完成 的 响应 ， 
程序 可 以 给 用 户 发 送 包 含 新 上 传 的 文件 链接 的 邮件 。 这 会 使 用 到 我 们 之 前 没有 接触 
过 的 模块 一 --Emailjs。 该 模块 提供 基本 的 邮件 功能 。 


通过 npm 安装 Emailjs: 
npm install emailjs 


上 传 PDF 的 表单 很 简单 ， 不 需要 解释 什么 。 除 了 用 户 名 和 邮件 地 址 之 外 额外 添加 了 
一 个 用 于 输入 文件 的 区 域 ， 并 设置 method 属性 为 POST，action 为 该 网 络 服务 。 因 
为 我 们 上 传 的 是 文件 , 所 以 enctype 字段 必须 被 设置 为 multipart/from-data。 示例 12-2 
显示 了 完成 的 表单 页 面 。 


例 12-2 上 传 PDF 文件 的 表单 


<!doctype html> 
<html lang="en"> 
<head> 
<meta charset="utf-8"/> 
<title>Upload PDF</title> 
<script> 
window.onload = function () { 
document .getElementById ('upload').onsubmit = function () { 
document .getElementById ('submit').disabled = true; 
}; 
} 
</script> 
</head> 
<body> 
<form id="upload" method="POST" action="http://localhost:8124" 
enctype="multipart/form-data"> 
<p><label for="username">User Name:</label> 
<input id="username" name="username"™ type="text" size="20" required/></p> 
<p><label for="email">Email:</label> 
<input id="email" name="email" type="text" size="20" required/></p> 
<p><label for="pdffile">PDF File:</label> 
<input type="file" name="pdffile" id="pdffile" required/></p> 
<p> 
<p> 


<input type="submit" name="Submit" id="submit" value="Submit"/> 
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</p> 
</form> 
</body> 


RARER WA J — FP im JavaScript 的 技能 了 ， 在 表单 提交 的 时 候 禁 止 button 
的 提交 事件 。 上 述 表单 使 用 了 HTML required 属性 , 可 以 确保 需要 的 属性 数据 存在 。 


提供 网 络 服务 的 应 用 程序 可 以 使 用 Connect 中 间 件 同时 处 理 对 表单 的 请 求 以 及 PDF 
上 传 。 这 次 没有 使 用 Express 架构 。 


在 程序 中 ，Connect static 中 间 件 用 于 提供 静态 文件 服务 ，directory 中 间 件 用 于 在 目录 
被 访问 时 美化 打印 目录 中 的 列表 。 其 他 需要 的 功能 就 是 解析 上 传 PDF 文件 和 表单 数据 
的 过 程 。 程 序 使 用 Connect parseBody 方法 ， 用 于 处 理 POST 过 来 的 各 种 类 型 的 数据 : 


connect () 


.use (connect .bodyParser({uploadDir: _— dirname + '/pdfs'})) 
-use(connect.static(_dirname + '/public')) 
.use(connect.directory(__dirname + '/public') ) 

-listen (8124); 


接 下 来 这 些 数据 会 传递 给 一 个 目 定 义 的 中 间 件 upload. upload 可 以 处 理 数据 ， 并 调 
用 自 定 义 的 模块 来 处 理 PDF 文件 。bodyParser 中 间 件 将 可 以 从 request.body Xt% P 
取得 username, email 信息 ， 并 从 request.files 对 象 中 获取 上 传 的 文件 。 如 果 文 件 上 
传 完 成 ， 会 被 作为 pdffile 对 象 ， 这 是 表单 里 文件 上 传 区 域 的 名 字 。 你 需要 对 文件 
type 进行 额外 的 测试 来 保证 上 传 的 文件 是 PDF 类 型 。 


示例 12-3 中 包含 PDF 服务 程序 的 全 部 代码 。 
示例 12-3 PDF 上 传 网 络 服 务 程序 


var connect = require ('connect'); 
var pdfprocess = require ('./pdfprocess'); 
// 如 果 POST 


// 上 传 文件 ，PDF QA, ack 响应 
function upload(req, res, next) { 
if ('POST' != req.method) return next(); 


res.setHeader('Content-Type', 'text/html1') ; 
if (req.files.pdffile&&req.files.pdffile.type === 'application/pdf') { 
res.write('<p>Thanks ' + req.body.username + 
' for uploading ' + req.files.pdffile.name + '</p>'); 
res.end("<p>You'11 receive an email with file links when processed.</p>") ; 


// post 上 传 处 理 
pdfprocess.processFile(req.body.username, req.body.email, 
req.files.pdffile.path, req.files.pdffile.name 
) 
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} else { 

res.end('The file you uploaded was not a PDF"); 

} 

} 

// 按 顺 序 

// 静态 文件 

// POST -上 传 文件 

// KH, BRINK 

connect () 
.use(connect.bodyParser({uploadDir: dirname + '/pdfs'})) 
.Use (connect.static(__dirname + '/public')) 
.use (upload) 
.use(connect.directory( dirname + '/public') ) 
.listen (8124) ; 


console.log('Server started on port 8124'); 


在 自 定义 的 模块 pdfprocess 中 ， 程 序 按 以 下 步骤 处 理 PDF 文件 : 


l. 


vA 


S: 


4. 


S: 


6. 


如 果 pdfs 目录 下 没有 users 子 目录 则 创建 一 个 ; 

为 当前 上 传 的 PDF 文件 创建 一 个 包含 时 间 惟 的 唯一 命名 ; 

用 PDF 文件 名 和 时 间 戳 一 起 在 users 子 目录 下 为 PDF 创建 一 个 新 的 子 目 录 ; 
PDF 从 临时 的 上 传 文件 目录 转移 到 新 的 目录 中 ， 并 重 命名 ; 

PDF Toolkit 对 该 文件 进行 操作 ， 所 有 的 独立 PDF 文件 都 放 在 pdfs 目录 中 ; 
发 送 邮件 给 用 户 ， 包 含 可 以 访问 上 传 的 PDF 文件 以 及 页 面 的 链接 。 


文件 系统 的 功能 有 Node File System 模块 提供 ，email 功能 则 由 Emailjs 模块 负责 ， 
PDF Toolkit 功能 在 子 进程 中 完成 。 子 进程 并 不 返回 任何 数据 ， 所 以 只 能 捕捉 到 子 
进程 的 exit 和 error 事件 。 示 例 12-4 包含 了 程序 最 后 一 部 分 代码 。 


示例 12-4 处 理 PDF 文件 模块 和 发 送 包含 可 访问 文件 的 链接 给 用 户 
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var fs = require('fs'); 
var spawn = require('child process').spawn; 
Var emailjs = require('emailjs'); 


module.exports.processFile = function (username, email, path, filename) { 
// 首先 如 果 user 目录 不 存在 则 创建 user 目录 
fs.mkdir(_ dirname + '/public/users/' + username, function (err) { 
// 如 果 不 存 在 则 创建 文件 目录 
var dt = Date.now(); 
// 之 后 信息 使 用 的 链接 
var url = 'http://examples.burningbird.net:8124/users/' + username + 
"/" + dt + filename; 


// 放置 文件 的 目录 
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var dir = _dirname + '/public/users/' + username + '/' + 
dt + filename; 
fs.mkdir (dir, function (err) { 
if (err) 


return console.log(err); 
// ERZ 
var newfile = dir + '/' + filename; 
fs.rename(path, newfile, function (err) { 
if (err) 
return console.log(err); 


//purst pdf 
var pdftk = spawn('pdftk', [newfile, 'burst', ‘output', 
dir + '/page_%02d.pdf' ]); 
pdftk.on('exit', function (code) { 
console.log('child process ended with ' + code); 
if (code != 0) 
return; 
console.log('sending email'); 


// 发 送 邮件 


var server = emailjs.server.connect ({ 
user: 'gmail.account.name', 
password: 'gmail.account.passwod', 
host: 'smtp.gmail.com', 
port:587, 
tls:true 


} ) ; 


var headers = { 
text: "You can find your split PDF at ' + url, 
from: 'youremail', 
to:email, 
subject: 'split pdf' 
be 


var message = emailjs.message.create (headers) ; 


message.attach({data:"<p>You can find your split PDF at " + 
"<a href=" "turl tS" + url t Y</a>csp>", 
alternative:true}); 

server.send(message, function (err, message) { 

console.log(err || message); 

}); 

päftk: kill); 

Fi? 
pdftk.stderr.on('data', function (data) { 
console.log ('stderr: ' + data); 
} ) ; 
} ) 7 
}); 
}); 
}; 
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代码 中 粗 体 部 分 是 子 进 程 调用 PDF Toolkit。 语 法 如 下 : 


pdftk filename.pdf burst output /home/location/page_%02d. pdf 


参数 按 次 序 依 次 是 文件 名 ， 操 作 以 及 输出 目录 。 在 这 里 的 操作 burst， 是 指 将 
PDF 分 解 为 不 同 的 独立 页 面 。Output 目录 告诉 PDF Toolkit 将 分 解 后 的 页 面 放 
在 指定 的 目录 中 ， 并 提供 了 格式 化 的 页 面 名 称 。 比 如 第 一 页 为 page_01.pdf， 
第 二 BA page_02.pdf， 以 此 类 推 。 我 们 本 来 可 以 使 用 Node 的 process.chdir 来 
改变 进程 执行 的 目录 ， 但 是 指定 了 PDF Toolkit 操作 的 目标 路 径 就 不 需要 这 种 
ATs 


发 送 E-mail 使 用 Gmail 的 SMTP R3 AF, (EJH TLS ( Transport Layer Security, & 
全 传输 层 )， 端 口 为 587， 需 要 指定 Gmail 用 户 名 和 密码 。 当 然 ， 你 还 可 以 使 用 自 
CLA SMTP 服务 器 。 发 送 的 邮件 内 容 既 有 纯 文 本 也 有 HTML 格式 附件 ( 对 于 使 用 
邮件 客户 端 可 以 处 理 HTML 格式 的 用 户 )。 


程序 的 结果 就 是 发 送 一 个 链接 给 用 户 ， 使 用 户 可 以 直接 访问 上 传 的 PDF 和 分 解 后 
的 页 面 。Connect directory 中 间 件 确保 了 目录 的 内 容 可 以 正常 显示 。 图 12-1 显示 上 
传 了 一 个 很 大 的 关于 全 球 变 暖 的 PDF 文件 的 结果 。 











: fisting directory /users/shetleyp/1 333308 












& L [| _ examples. uring net8124/ Fusers steve /1333308807783ur i. g: P] e a 


i Resize a Toole | + View Source” he 


fusers / shelleyp / 1333308807 783unclimatereport pdf / 


图 12-1 
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page 02 odf 


page 09 pdf 


page 10 1nd 


page 197 pdf 


paye TT pdf 
page TD edi 
page TiS gd 


pege THA pel 


pege 120 od? 





上 传 大 文件 ， 
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page Of pel 
page O04 pdf 
page OF pct 


page 10 puf 


gage 102 pdt 
page 105 pelt 


page 108 pH 


page 110 ge 


page 113 gelf 


page 11 pdi 


page T13 mH 


gage ii pdt 


vage DZ pdf 
paye 05 puii 
page 0E paf 
page 100 pdf 
page 102 pdf 
sage 105 gd 
page 109 pdf 
ange 4114 pof 
page 14 rf 
page TT? pelf 
mage 12 pdf 


page 122 pall 


过 PDF Toolkit 分 解 后 的 最 终结 果 





用 这 种 通过 E-mail 发 送 确认 信息 给 用 户 的 实现 方式 , 用 户 不 需要 一 直 等 待 PDF 的 处 
理 过 程 ( Node 服务 也 不 需要 一 直 挂 起 等 竺 处理 过 程 完 成 )。 


noe 提示 
as 当然 ,用户 依 然 需要 花费 时 间 在 上 传 PDF 文件 上 , 本 程序 并 不 涉及 与 
2 1. 大 文件 上 传 有 关 的 问题 


12.1.2 使 用 PDFKit 创建 PDF 

如 果 你 想 要 的 不 是 使 用 子 进 程 和 命令 行 工具 ， 或 者 你 需要 创建 PDF 并 且 可 以 管理 
现 有 的 PDF, Node 有 一 些 模块 提供 了 这 种 PDF 功能 的 支持 , 使 用 最 多 的 是 PDFKit。 
PDFKit 是 用 CoffeeScript 编写 的 ， 但 是 你 并 不 需要 了 解 CoffeeScript 才能 使 用 该 模 
Hk, 因为 API 是 暴露 给 JavaScript 使 用 的 。 该 模块 提供 了 创建 PDF 文档 , 添加 页 面 ， 
组 织 文 本 和 网 形 以 及 藤 入 图 片 的 功能 。 该 模块 未 来 的 功能 除了 这 些 , 还 应 该 添加 其 
他 的 ， 如 PDF 提纲 、 渐 变 、 表 格 以 及 其 他 特性 。 

使 用 npm 安装 PDFKit: 


npm installpdfkit 


在 程序 中 ， 以 创建 一 个 新 的 PDF 文档 作为 开始 : 

var doc = new PDFDocument (); 
接 下 来 , 你 可 以 使 用 API 添加 字体 、 新 的 网 页 、 图 形 。 为 了 简化 开发 过 程 可 以 链 式 
调用 API 方法 。 


为 了 说 明 如 何在 JavaScript 中 使 用 该 模块 ， 我 将 模块 开发 人 员 的 一 个 CoffeeScript 
例子 转换 为 JavaScript。 从 头 开 始 , 创建 好 PDF 文档 之 后 , 为 文档 添加 一 个 TrueType 
字体 ， 字 号 设置 为 23pix， 设 置 文本 坐标 为 (100，100 ): 


qoc.font('fonts/GoodDog-webfont .ttf') 
.fontSize (25) 
.text('Some text with an embedded font! ', 100, 100); 


之 后 , 需要 添加 一 个 新 的 PDF 页面, 重新 设置 字号 为 25pix, 新 文本 坐标 为 ( 100，100 ): 
doc.addPage () 


.fontSize (25) 
.text('Here is some vector graphics...', 100, 100); 


保存 文档 的 坐标 系统 ， 调 用 回 量 图 形 功 能 来 画 一 个 红色 的 三 角 : 
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doc.save() 
-moveTo (100,150) 
. LineTo (100,150) 
.lineTo (200,250) 
perl ("EP SSOO") 3 


下 一 部 分 代码 设置 坐标 系统 比例 为 0.6， 转 换 了 原点 ， 画 了 一 个 星星 的 边沿 ， 填 充 
红色 ， 然 后 将 文档 恢复 为 初始 的 坐标 系统 和 比例 : 


doc.scale(0.6) 
-.translate(470, -380Q) 
.path('M 25,75 L 323, 301 131, 161 369,161 177, 301 277 
.fill('red', 'even-odd') 
.restore(); 


如 果 你 使 用 其 他 的 向 量 图 形 系 统 ， 比 如 Canvas， 这 部 分 看 起 来 应 该 很 熟悉 。 如 果 
没有 使 用 过 ， 你 可 以 先 学 习 后 续 部 分 的 Canvas 例子 ， 然 后 再 回 到 这 个 例子 。 


添加 男 一 个 页 面 , 填充 颜色 修改 为 蓝 色 ， 并 在 页 面 添 加 链接 。 随 后 将 该 文档 写成 一 
个 output.pdf 文件 : 
doc.addPage () 
.£111Color ("blue") 
.text('Here is a link!', 100, 100) 
-underline(100, 100, 160, 27, {color:"#0000FF"}) 


-Link(100, 100, 160, 27, ‘http://google.com/'); 
doc.write('output.pdf'); 


手动 创建 PDF 文档 是 一 个 繁琐 的 过 程 。 但 是 ,我 们 可 以 很 容易 编写 程序 利用 PDFKit 
API 接收 数据 存储 的 内 容 并 生成 PDF。 我 们 也 可 以 使 用 PDFKit 按 要 求生 成 网 页 的 
PDF 文档 ， 或 者 提供 可 供 保 存 数据 的 截图 。 


要 知道 的 是 ， 模 块 的 很 多 方法 都 不 是 异步 的 ， 所 以 在 生成 PDF 的 过 程 中 需要 一 直 
等 待 ， 所 以 具体 情况 具体 分 析 。 


12.2 ”从 子 进程 访问 ImageMagick 


ImageMagick 是 一 个 支持 MAC,Windows 和 Unix 操作 系统 的 很 强大 的 命令 行 图 形 
工具 。 可 以 用 ImageMagick 来 裁 甬 图 片 或 者 重 定义 图 片 大 小 ， 访 问 图 片 的 数据 元 ， 
制作 动画 及 很 多 特效 。 同 时 ImageMagick 占用 很 多 资源 ,操作 时 间 较 长 , 通常 由 图 
片 的 不 同 大 小 和 操作 决定 。 
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Node 有 很 多 有 关 ImageMagick 的 模块 。 其 中 一 个 模块 就 是 imagemadick, 提供 了 对 
ImageMagick 功能 的 封装 。 但 是 这 个 模块 已 经 一 段 时 间 没 有 更 新 了 。 另 一 个 模块 是 
gm， 提 供 了 一 系列 预定 义 的 功能 ， 在 后 台 与 ImageMagick 交互 。 你 可 能 会 发 现 使 
用 这 些 模块 与 直接 使 用 ImageMagick 一 样 简单 。 在 Node 程序 中 使 用 ImageMagick 
你 所 需要 做 的 全 部 事情 就 是 安装 ImageMagick 以 及 调用 子 进 程 。 


ImageMagick 提供 了 可 供 使 用 的 不 同 工 具 来 完成 不 同 功能 : 
animate 

在 图 形 界面 上 制作 动画 。 
compare 

提供 原 图 与 修改 后 的 图 片 在 参数 和 视觉 效果 上 的 差异 对 比 。 
composite 

重合 两 个 图 像 。 
conjure 

执行 Magick Scripting Language ( MSL ) 语言 描述 的 脚本 。 
convert 

使 用 任意 可 能 的 操作 对 图 形 进行 转换 ， 比 如 裁剪 、 重 定义 大 小 以 及 添加 特效 。 
display 

在 图 形 界面 上 显示 图 像 。 
identify 

描述 一 个 图 像 或 者 多 个 图 像 文件 的 格式 和 其 他 特性 。 
import 

在 图 形 界 面 上 对 可 见 的 窗口 截图 并 保存 为 文件 。 
mogrify 


在 原 图 上 对 图 形 进行 修改 (BY. HE IV). PIE ) 并 直接 保存 修改 后 的 
SiR A 
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montage 
合并 图 形 。 
stream 
流 式 存储 图 片 ， 一 次 一 个 像素 。 


其 中 几 种 工具 都 与 图 形 界面 有 关 ， 从 Node 程序 角度 来 看 没有 什么 意义 。 但 是 ， 
convert, mogrify, montage, identify 和 stream 几 个 工具 在 Node 程序 中 有 非常 有 趣 
的 用 法 。 在 本 节 和 下 一 节 中 ， 我 们 主要 介绍 其 中 一 个 : convert. 

提示 

尽管 我 们 的 关注 点 是 convert, 要 知道 本 章 中 所 讲 到 的 内 容 都 可 以 用 于 
mogrify， 除 了 mogrify 本 身 的 修改 会 履 盖 原 图 。 





convert 丁 具 是 ImageMagick 的 主要 部 分 。 依 助 convert， 你 可 以 对 图 形 进 行 一 些 奇 
妙 的 转换 ,然后 将 结果 存 为 男 一 个 文件 ,你 可 以 提供 一 个 适度 的 模糊 或 者 锐 化 图 片 ， 
给 网 片 添加 文字 注释 , 将 图 片 作为 背景 ,裁剪 , 重 定 义 大 小 甚至 用 颜色 填充 工具 替 
换 掉 图 像 中 每 一 个 像素 的 颜色 。 几 乎 没有 什么 是 ImageMagick 不 能 做 到 的 。 当 然 ， 
并 不 是 每 个 操作 都 是 等 价 的 , 特别 是 当 你 考虑 到 操作 可 能 耗费 时 间 的 时 候 。 一 些 图 
形 转换 可 能 很 快 ， 另 一 些 可 能 相当 漫长 。 

为 了 演示 如 何在 Node 程序 中 使 用 convert， 示 例 12-5 中 的 小 自 含 型 程序 通过 命令 


行 指定 了 一 个 图 片 名 ,然后 调整 图 片 大 小 使 其 适应 一 个 览 度 不 超过 150px 的 空间 。 
不 管 其 原始 类 型 ， 将 图 片 格式 转换 为 PNG. 


这 个 过 程 的 命令 行 实 现 方式 为 : 
convert photo.jpg -resize '150' photo.jpg.png 
我 们 需要 为 子 进程 参数 数组 传递 四 个 数据 : 原始 图 片 ，-resize 标识 ，-resize 标识 的 
数值 ， 新 网 片 的 名 称 。 
示例 12-5 在 Node 程序 中 使 用 ImageMagick convert 工具 调整 图 片 大 小 


var spawn = regquire('child_process') .spawn; 
// 获取 图 片 

var photo = process.argv([2]; 

// 转换 参数 数组 

var opts = [ 

photo, 
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'"-resize', 
'150', 
photo + ".png"]; 


// convert 


var im = spawn('convert', opts); 
im.stderr.on('data', function (data) { 
console.log('stderr: ' + data); 


b); 
im.on('texit', function (code) { 
if (code === 0) 
console.log('photo has been converted and is accessible at ' 
+ photo + ".png'); 

}); 
ImageMagick convert 工具 悄 无 声 县 地 处 理 完 图 片 ， 没 有 子 进 程 的 data 事件 需要 处 
理 。 我 们 唯一 需要 关心 的 事件 是 当 图 像 处 理 完毕 后 的 error 和 exit 事件 。 


当 你 想 完成 一 个 更 复杂 的 图 形 处 理 的 时 候 像 ImageMagick 这 种 程序 开始 变 得 有 趣 。 
一 个 很 受 欢迎 的 ImageMagick 图 形 效 果 是 拍 立 得 特效 : 沿 中 心 轻微 旋转 图 片 , 添加 
border 和 shadow ( 阴影 ) 使 图 片 看 起 来 像 拍 立 得 的 照片 。 这 种 效果 非常 受 欢 迎 ， 
所 以 已 经 有 预先 定义 的 设置 。 但 是 在 使 用 新 的 预定 义 设置 之 前 , 我 们 需要 使 用 如 下 
的 命令 行 (来 自 于 ImageMagick 用 例 ): 
convert thumbnail.gif \ 

-bordercolor white -border 6 \ 

-bordercolor grey60 -border 1 \ 

-background none -rotate 6 \ 

-background black \( +clone -shadow 60x4+4+4 \) +swap \ 


-background none -flatten \ 
polaroid.png 


参数 很 多 , 并 且 参 数 的 格式 之 前 并 没有 见 到 过 。 接 下 来 应 该 怎样 将 其 转换 为 子 进 程 
的 参数 数组 呢 ? 


详细 分 析 下 。 


在 命令 行 中 看 起 来 像 单个 参数 的 (\( +clone -shadow 60x4+4+4 \) ) 绝 不 是 Node Fit 
程 。 示 例 12-6 是 示例 12-5 中 的 转换 工具 的 一 个 变形 ， 用 图 片 的 拍 立 得 特效 替换 了 
原来 对 图 片 大 小 的 调整 。 特 别 注 意 一 下 粗 体 的 部 分 。 


示例 12-6 在 Node 程序 中 使 用 ImageMagick 为 图 片 添 加 Polaroid 效果 


var spawn = require('child_process').spawn; 
// 获取 图 片 
var photo = process.argv[2]; 
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// 转换 为 数组 

var opts = [ 

photo, 

"-bordercolor", "snow", 
"-border", "6", 
"-background", "grey60", 
"-background", "none", 
"-rotate", "6", 
"-background", "black", 
"(", "+clone", "-shadow", "60x4+4+4", ")", 
"+swap", 

"—background", "none", 
"-flatten", 

photo + ".png"]; 


var im = spawn('convert', opts); 


代码 中 粗 体 部 分 说 明了 命令 行 中 的 一 个 参数 如 何 成 为 子 进程 的 五 个 参数 ,程序 运行 
结果 如 图 12-2 所 示 。 











12-2 Node 程序 运行 结果 ， 图 片 添加 了 拍 立 得 特效 


在 Node 程序 不 可 能 通过 命令 行使 用 ImageMagick 子 进程 ， 毕 竞 你 可 以 直接 运行 
ImageMagick 工具 。 但 是 你 可 以 使 用 进程 和 ImageMagick 工具 混合 的 方式 在 一 张 图 
片上 进行 多 个 会 话 , 或 者 通过 网 站 提供 服务 ( 比如 允许 用 户 修改 图 片 大 小 作为 头像 ， 
或 者 在 资源 功效 的 网 站 上 为 上 传 图片 打 水 印 )。 
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创建 一 个 使 用 ImageMagick 的 Web 应 用 的 关键 点 与 之 前 的 PDF 程序 一 样 : 如 果 处 
理 过 程 变 得 很 慢 ( 特别 是 应 对 数量 巨大 的 并 发 用 户 )， 你 需要 考虑 提供 允许 上 传 图 
片 文件 然后 提供 链接 给 用 户 完成 操作 〈 网 站 或 者 E-mail 都 可 以 ) 的 异步 处 理 方式 ， 
而 不 是 一 百 等 到 所 有 处 理 完成 。 


我 们 可 以 修改 示例 12-3 和 示例 12-4 的 代码 ， 对 任何 上 传 的 图 片 都 添加 拍 立 得 的 效 
果 。 并 且 ， 我 们 还 可 以 将 示例 12-3 代码 转换 为 一 个 模块 ， 可 以 被 重用 于 类 似 的 场 
景 : 一 个 文件 处 理 过 程 ， 为 上 传 文件 创建 子 目 录 ,， 运行 进程 ， 并 在 同一 个 目录 中 存 
储 处 理 完成 的 结果 。 


12.3 通过 HTTP 提供 HTML5 Video 服务 


在 第 6 章 中 我 们 创建 了 一 个 简单 的 HTTP 服务器， 提供 静态 文件 和 基本 目录 服务 ， 可 
以 处 理 404 错误 。 我 们 用 于 测试 该 程序 的 一 个 网 页 包含 了 黄 入 的 HTMLS video。 该 网 
页 通过 一 个 工具 允许 用 户 在 视频 播放 期 间 任 意 时 间 点 上 点 击 来 暂停 或 者 播放 视频 。 


包含 HTMI5 video 的 程序 需要 使 用 Connect 模块 的 静态 网 络 服务 器 而 不 是 自制 的 Web 
服务 夭 。 这 一 选择 的 原因 在 于 月 制 Web 服务 硕 无 法 处 理 HTTP ranges。 类 似 于 Apache 
和 IIS 的 HTTP HRA Asal x FF range, Connect 模块 也 文 持 ， 但 是 我 们 的 静态 服务 需 
不 文 持 。 


在 本 节 中 ， 我 们 会 对 示例 6-2 中 的 Web 服务 器 添加 支持 range 的 功能 。 


Wa 提示 
支持 range 所 能 提供 的 服务 远 远 不 止 HTML5 video， 还 可 以 用 于 下 载 
% 大 容量 的 文件 ， 


Range 位 于 HTTP header 中 , 用 于 提供 下 载 资 源 的 开始 和 结束 位 置 , 比如 视频 文件 。 
以 下 是 我 们 支持 HTTP range 的 步骤 . 


I. response header 中 添加 Accept-Ranges:bytes 表示 可 以 处 理 带 有 range RDR; 
2， 在 request header 中 查找 range 请 求 信息 ; 

3， 如 果 找到 range 请 求 ， 解 析出 开始 和 结束 位 置 的 信息 ; 

4， 验 证 开始 和 结束 信息 的 值 都 是 数字 ， 并 且 不 超出 所 访问 的 资源 的 长 度 ; 


5. 如 果 没 有 提供 结束 信息 ， 则 设置 结束 位 置 为 资源 长 度 。 如 果 没 有 提供 开始 信息 ， 
设置 为 0; 
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6. 在 response header 中 创建 Content-Range 用 于 保存 开始 ， 结 束 和 资源 长 度 信息 ; 


7. 在 response-header 中 创建 Content-Length 保存 通过 结束 和 开始 信息 计算 出 来 的 
请 求 资源 信息 长 度 的 结果 ; 


8 将 状态 码 从 200 KAA 206 ( 部 分 情况 下 ); 
9. 将 一 个 包含 开始 和 结束 位 置信 息 的 对 象 传 递 给 createReadStream 方法 。 


当 一 个 Web 客户 端 请 求 Web HRS a SET OE, Web 服务 右 可 以 告知 客户 并 服务 
器 支持 range， 并 通过 以 下 header 内 容 提 供 range 基本 单位 : 


Accept-Ranges: bytes 


所 以 对 Web HRs a5 — “Tins SUE BN) A Ace HS header 内 容 : 


res.setHeader('Accept-Ranges', 'bytes'); 


客户 端 接 下 来 会 按 以 下 格式 发 送 range 请 求 : 


bytes=startnum-endnum 


startnum/endnum 值 是 range 的 开始 值 和 结束 值 。 在 播放 过 程 中 可 以 多 次 发 送 这 类 请 
求 。 比 如 ， 以 下 内 容 就 是 实际 情况 中 在 包含 HTMLS video 的 网 页 上 ， 当 视频 开始 
播放 后 在 播放 过 程 中 点 击 时 间 轴 ， 从 页 面 发 出 的 range 请 求 内 容 : 


bytes=0- 
bytes=7751445-53195861 
bytes=18414853-53195861 
bytes=15596601-18415615 
bytes=29172188-53195861 
bytes=39327650-53195861 
bytes=4987620-7751679 
bytes=17251881-18415615 
bytes=17845749-18415615 
bytes=24307069-29172735 
bytes=33073712-39327743 
bytes=52468462-53195861 
bytes=35020844-39327743 
bytes=42247622-52468735 


对 我 们 的 服务 器 来 说 , 下 一 步 需要 添加 的 就 是 检查 是 否 为 range 请 求 , 如 果 是 的 话 ， 
解析 出 来 开始 和 结束 值 。 检 查 range 请 求 代码 为 : 


if (req.headers.range) {...} 
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我 创建 了 一 个 processRange RGE range 中 的 开始 和 结束 值 。processRange 按 横 
RT. (-) 分 解 字 符 串 ， 然 后 从 分 解 后 的 两 个 字符 串 中 提取 数字 。 该 辆 数 检查 了 起 始 值 是 
否 人 存在 ， 类 型 是 否 为 数字 并 且 有 没有 超过 文件 的 长 度 ( 如 果 请 求 中 的 range 值 不 合法 ， 
则 返回 416 TRAST), 同时 也 对 结束 点 的 值 做 了 类 似 上 述 的 检查 , 当 结 束 值 不 存在 的 时 
候 则 设置 结束 点 为 视频 文件 长 度 。 该 方法 返回 一 个 包含 开始 和 结束 值 的 对 象 : 


function processRange(res, ranges, len) { 
var start, end; 


// 从 range 中 提取 start 和 stop 


var rangearray = ranges.split('-'); 


start = parseInt (rangearray[0].substr(6)); 
end = parseInt (rangearray[1]); 


if (isNaN(start)) start = 0; 
if (1sNaN(end)) end = len -1; 


// Æ start 超过 文件 长 度 

if (start >len - 1) { 
res.setHeader('Content-Range', 'bytes */' + len); 
res.writeHead (416); 
res.end(); 


// end 不 能 超过 文件 长 度 
if (end >len - 1) 
end = len - l; 
return {start:start, end:end}; 


} 


该 功能 的 下 一 个 部 分 是 在 reponse header 中 添加 Content-Range， 提 供 range 的 起 始 
值 和 请 求 资源 的 长 度 ， 格 式 如 下 : 


Content-Range bytes 44040192-44062881/44062882 


Response header 中 也 要 包含 内 容 的 长 度 ( Content-Length )， 由 结束 值 减 去 开始 值 计 
算 ，HTTP 状态 码 设置 为 206， 表 示 Partial Content ( 部 分 内 容 )。 i 


最 后 ，start 和 end 值 也 被 作为 选项 在 调用 时 传递 createReadStream 方法 。 这 一 实现 
确保 了 请 求 到 的 流 资 源 在 完整 流 媒 体 中 的 正确 位 置 。 

示例 12-7 将 对 Web 服务 带 的 修改 汇总 到 一 起 , 现在 可 以 提供 HTMLS video range 服务 。 
示例 12-7 支持 range 的 Web 服务 器 


var http = require('http'), 


url = require('url'), 
fs = require('fs'), 
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mime = require('mime'); 


function processRange(res, ranges, len) { 


} 


var start, end; 


// range 中 提取 start 和 end 


Var rangearray = ranges.split('-'); 


start = parseInt (rangearrayl0] .substr(6)); 
end = parseInt (rangearray[1]); 


if (isNaN(start)) start = 0; 
if (isNaN(end)) end = len -1; 


// @ start 超过 文件 长 度 


if (start >len - 1) { 


res.setHeader('Content-Range', 'bytes */' 


res.writeHead (416); 
res.end(); 

} 

//end 不 能 超过 文件 长 度 

if (end >len - 1) 
end = len - 1; 


return {start:start, end:end}; 


http.createServer(function (req, res) { 


pathname = _ dirname + '/public' + req.url; 


fs.stat(pathname, function (err, stats) { 
if (err) { 
res.writeHead (404); 
res.write('Bad request 404\n'); 
res.end(); 
} else if (stats.isFile()) { 


var opt = {}; 


// 如 果 没 有 range 


res.statusCode = 200; 


varlen = stats.size; 


// WA range 的 请 求 


if (req.headers.range) { 


opt = processRange(res, req.headers.range, 


len); 


// 设置 长 度 


len = opt.end - opt.start + 1; 


// 设置 状态 码 206 

res.statusCode = 206; 

// 设置 header 

var ctstr = ‘bytes ' + opt.start + '-" + 
opt.end + '/' + stats.size; 


res.setHeader ('Content-Range', ctstr); 
} 
console.log('len ' + len); 
res.setHeader ('Content-Length', len); 


// 内 容 类 型 


var type = mime.lookup (pathname) ; 
res.setHeader('Content-Type', type); 
res.setHeader('Accept-Ranges', ‘'bytes'); 


// 创建 可 读 取 的 流 
var file = fs.createReadStream(pathname, opt); 
file.on("open", function () { 


file.pipe(res) ; 

ras 

file.on("error", function (err) { 
console.log (err); 


}); 


} else { 
res.writeHead (403); 
res.write('Directory access is forbidden'); 
res.end(); 
} 
} ) ; 
}).listen (8124); 
console.log ('Server running at 8124/'); 


对 Web Hk ar Aeon a S HTTP 以 及 其 他 网 络 功能 并 不 复杂 ， 只 是 很 繁琐 。 关 
键 之 处 在 于 将 每 个 功能 分 解 为 较 小 的 独立 功能 ， 然 后 每 次 添加 一 个 小 功能 的 代码 
(完成 之 后 进行 测试 )。 


现在 ， 用 户 可 以 在 网 页 〈 例子 中 的 网 页 ) 上 视频 播放 的 时 间 轴 上 进行 点 击 了。 


12.4 创建 和 流 化 画布 内 容 (Canvas Content) 
canvas 元 素 成 为 游戏 开发 人 员 、 艺 术 家 和 统计 人 员 的 最 爱 ， 因 为 canvas 70% A 
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在 客户 端 页 面 上 创建 动态 和 交互 式 的 图 形 。Node 中 也 有 支持 canvas 的 模块 ， 比 如 
本 节 即 将 介绍 的 node-canvas， 或 者 canvas ( 本 节 我 们 使 用 node-canvas )。Node-canvas 
模块 是 基于 Cario 的 路 平台 的 向 量 网 形 库 ， 长 久 以 来 次 受 开 发 人 员 喜 爱 。 


Npm 安 冯 node-canvas : 


npm install canvas 
node-canvas 模块 可 以 提供 你 在 客户 端 页 面 上 使 用 到 的 所 有 canvas 功能 。 创 建 一 个 
Canvas 对 象 和 context， 然 后 在 context 中 进行 绘画 ， 可 以 显示 结果 或 者 将 结果 保存 
为 JPEG 或 者 PNG。 


Fa 提示 
需要 知道 的 是 ，Canvas 中 的 一 此 功能， 比如 在 图 形 上 进行 操作 ， 都 要 
à K Cario 1.10 版 本 以 上 。 


有 一 些 附加 的 功能 只 能 用 于 服务 器 而 不 能 用 于 客户 端 。 服 务 器 端 允 许 流 化 Canvas 
对 象 为 一 个 文件 (PNG 或 者 JPEG )， 为 之 后 的 访问 固化 资源 。 还 可 以 将 Canvas 对 
象 转换 为 数据 的 URI， 包 含 img 元 素 的 HTML 页 面 ， 或 者 从 外 部 资源 ( 比如 文件 
或 者 Redis 数据 库 ) ERK A HHF Canvas 对 象 。 


进入 正题 介绍 如 何 使 用 node-canvas 模块 ,示例 12-8 创建 canvas 画布 并 为 之 后 的 访 
问 流 化 图 片 为 PNG 文件 。 例 子 中 使 用 了 Mozilla Developer Network 例子 中 的 旋转 
后 的 图 片 ， 添 加 了 边界 和 阴影 。 完 成 之 后 ， 流 化 为 PNG 文件 方便 之 后 访问 。 很 多 
客户 问 程 序 可 以 使 用 的 功能 也 可 以 用 于 Node 程序 。 真 正 只 属于 Node 的 部 分 是 在 
最 后 将 图 形 存储 为 文件 。 


示例 12-8 通过 node-canvas 创建 图 形 并 存储 为 PNG 文件 


var Canvas = require('canvas'); 
var fs = require('fs'); 


// 创建 canvas and context 
var canvas = new Canvas(350, 350); 
var ctx = canvas.getContext('2d'); 


// 创建 带 了 表 影 的 长 方形 
// 存储 context 
ctx.save(); 
ctx.shadowOffsetX = 10; 
ctx.shadowOffsetYy = 10; 


ctx.shadowBlur = 5; 
ctx.shadowColor = 'rgba(0,0,0,0.4)'; 
ctx.fillStyle = '#fff'; 
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ctx.fillRect (30, 30, 300, 300); 
// 完成 阴影 

ctx.restore(); 

ctx.strokeRect (30, 30, 300, 300); 


// MDN 例子 : 优化 图 片 ， 在 之 前 创建 出 来 的 正方 形 

// 中 插入 偏 移 量 

ctx.translate (125, 125); 

for (i = 1; i< 6; i++) { 
ctx.save(); 
ctx.fillStyle = 'rgb(' + (51 * i) + ',' + (255 - 51 * i) + ',255)'; 
for (j = 0; j <i * 6; j++) { 
ctx.rotate(Math.PI * 2 / (i * 6)); 
ctx.beginPath(); 
ctx.arc(0, i * 12.5, 5, 0, Math.PI * 2, true); 
Ctxsf1iL1()s 


ctx.restore(); 
} 
// 存储 为 PNG 文件 
var out = fs.createWriteStream(_ dirname + '/shadow.png'); 
var stream = canvas.createPNGStream(); 


stream.on('data', function (chunk) { 
out.write (chunk) ; 

} ) ; 

stream.on('end', function () { 
console.log('saved png"); 


BE 


一 旦 运行 了 Node 程序 , HEI 
RIF o 


的 浏览 天 访问 shadow.png. 图 12-3 显示 了 生成 的 


> 

















12-3 node-canvas 生成 的 图 形 
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你 并 不 会 像 在 网 页 中 一 样 在 Node 程序 中 使 用 Canvas 对 象 。 一 个 使 用 node-canvas 
的 例子 是 动态 的 时 钟 ， 需 要 不 断 的 HTTP 刷新 。 如 果 你 需要 一 个 客户 端的 动态 时 钟 ， 
则 需要 在 客户 端 使 用 canvas 元 素 。 


Canvas 对 于 服务 需 的 意义 在 于 提供 了 服务 器 通过 数据 表达 图 形 的 能 力 ， 比 如 数据 
EAH, Redis 数据 库 中 的 数据 ， 日 志文 件 或 者 其 他 一 些 服务 器 上 的 原生 数据 。 在 
服务 器 上 生成 图 形 不 仅 提 供 了 后 续 访 问 的 能 力 , 还 可 以 通过 在 服务 器 上 处 理 图 形 来 
限制 客户 端的 数据 流 ， 而 不 是 通过 发 送 数据 到 客户 端 再 生成 图 形 。 


在 Node 程序 中 使 用 canvas 的 意义 还 存在 于 用 于 处 理 游戏 中 需要 适应 用 户 操作 的 组 
件 ， 特 别 是 生成 之 后 需要 多 次 访问 的 情况 。 


270 第 12 章 


第 13 章 


WebSockets 和 Socket.IO 


在 本 章 中 ， 我 们 将 通过 实现 一 些 客户 端 与 服务 端 示 例 程 序 ， 来 对 WebSockets 和 
Socket.IO 进行 说 明 。 


WebSockets 是 一 个 相对 较 新 的 Web 技术 ， 它 能 在 客户 端 与 服务 顺应 用 程序 之 间 建 
立 直接 的 实时 双向 通信 。 该 通信 是 基于 TCP 协议 (传输 控制 协议 ) 的 ， 并 通过 套 
接 字 接口 实现 。SocketIO 库 为 实施 这 项 技术 提供 了 必要 的 支持 。Socket.IO 不 仅 只 为 
Node 应 用 程序 提供 了 可 用 模块 , 它 还 包含 了 一 个 客户 端 JavaScript Æ, 以 便于 建立 
客户 端 通信 信道 ; 此 外 ， 它 还 可 以 作为 一 个 Express 中 间 件 使 用 。 


在 本 章 中 ， 我 将 对 Socket IO 在 客户 端 以 及 服务 闪 上 的 工作 原理 进行 介绍 ， 通 过 它 
我 们 能 更 好 地 了 解 WebSockets。 


13.1 WebSockets 


在 使 用 Socket-IO 之 前 , 我 想 对 WebSockets 先 做 下 简要 介绍 。 要 做 到 这 一 点 ， 首 先 
RIRE FAEN Lf (bidirectional full duplex communication ), 


全 驳 7 了 是 指 在 任何 形式 的 数据 通信 过 程 中 , 两 个 方向 上 的 传输 同时 进行 。 驳 了 是 指 
一 个 通信 的 两 个 端点 都 可 以 发 起 通信 。 与 此 相对 的 是 党 通信, 它 只 允许 通信 中 的 
一 个 端点 作为 数据 发 送 方 , 而 其 他 端点 都 是 接收 方 。WebSockets 为 Web 客户 端 ( 如 
浏览 器 ) 提供 了 与 服务 器 应 用 程序 建立 双向 全 双 工 通信 的 能 力 ， 而 且 它 没有 使 用 
HTTP 通信 ， 因 为 这 会 为 通信 处 理 增加 不 必要 的 开销 。 


WebSockets 是 标准 化 的 ， 它 属于 万 维 网 联盟 (W3C ) 制定 的 WebSockets API 规范 
的 一 部 分 。 该 技术 的 起 步 比较 曲折 ， 因 为 早期 的 一 些 浏览 句 于 2009 年 开始 实施 了 


271 


WebSockets, 但 却 导 致 了 严重 的 安全 问题 ,使 得 他 们 放弃 了 对 WebSockets 的 支持 ， 
或 者 只 将 它 作 为 一 个 可 选项 来 启用 。 


后 来 WebSockets 协议 做 了 改进 并 解决 了 安全 问题 ，FireFox、Chrome 和 Internet 
Explorer bt ar ah FFA WM. AB, Safari 和 Opera 还 只 能 支持 旧版 本 的 
WebSockets, ， 而 且 还 必须 通过 配置 选项 来 手动 启用 它 。 而 大 多 数 移动 浏览 器 对 
WebSockets 的 文 持 也 都 比较 有 限 ， 或 者 仅 支 持 早期 的 WebSockets 规范 。 


Socket.IO 库 定 位 于 解决 这 个 问题 ， 它 能 灵活 采用 不 同 机 制 在 客户 病 和 服务 需 之 间 
建立 双 辣 通信 ， 一 般 情 况 下 它 会 按 序 尝试 使 用 如 下 几 种 机 制 : 


e WebSockets 

e Adobe Flash Socket 

e Ajax long polling 

e Ajax multipart streaming 
e Forever iFrame for IE 


e JSONP Polling 


通过 这 个 列表 ， 我 们 可 以 看 出 : Socket.IO 能 够 为 当下 我 们 使 用 的 大 多 数 浏 览 器 提 
ERY NME SC FF 

提示 

虽然 技术 上 讲 ，WebSockets 并 不 是 一 个 具体 实现 ， 但 在 本 章 的 示例 中 ， 
我 依然 使 用 了 “WebSockets” 这 个 名 字 来 描述 这 项 通信 技术 ， 因 为 它 比 
bidirectional full-duplex communication 更 简短 。 





13.2 Socket.lO 简介 


在 开发 WebSockets 应 用 程序 之 前 ， 你 首先 需要 在 服务 器 上 安装 SocketIO。 我 们 可 
以 使 用 npm 来 安装 该 模块 : 

npm install socket.io 
一 个 Socket.IO 应 用 程序 包含 两 个 组 成 部 分 : 服务 端 应 用 和 客户 端 应 用 。 在 本 节 的 


示例 代码 中 ， 服 务 端 是 一 个 Node 应 用 程序 ， 而 客户 端 是 一 个 包含 有 JavaScript 代 
码 块 的 HTML 页 面 。 两 者 都 是 通过 修改 Socket.IO 网 站 提供 的 示例 代码 得 到 的 。 
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13.2.1 一 个 简单 的 通信 范例 

本 节 的 client/server 应 用 程序 演示 了 如 何在 客户 端 和 服务 需 之 间 建 立 通信 ， 然 后 往 
返 发 送 文本 字符 串 并 将 此 过 程 展 现在 页 面 上 。 客 户 端 会 将 最 近 接 收 到 的 字符 串 回 应 
给 服务 端 ， 服 务 端 则 修改 该 字符 串 并 将 其 册 发 送 回 客 户 痊 。 


客户 端 应 用 程序 使 用 Socket.IO 库 创 建 一 个 WebSockets 连接 ， 并 侦 听 任何 标记 为 
news 的 事件 。 当 接收 到 事件 后 ， 应 用 程序 会 提取 事件 所 携 齐 的 文本 信息 ， 并 把 它 
输出 到 Web 页 面 。 同 时 通过 echo 事件 将 文本 返回 给 服务 需 。 示 例 13-1 包含 了 客 
户 病 网 页 的 完整 代码 。 


示例 13-1 Socket-|lO 应 用 : 客户 端 HTML 页 面 


<!doctype html> 
<html lang="en"> 
<head> 
<meta charset="utf-8"> 
<title>bi-directional communication</title> 
<script src="/socket.io/socket.io.js"></script> 
<script> 
var socket = io.connect('http://localhost:8124' ); 
socket.on('news', function (data) { 
var html = '<p>' + data.news + '</p>'; 
document. getElementById( "output" ).innerHTML=html; 
socket.emit('echo', { back: data.news }); 


</script> 

</head> 

<body> 

<div id="output"></div> 
</body> 

</html> 


服务 端 应 用 程序 则 会 创建 一 个 HTTP 服务 对 象 ， 但 它 只 用 一 个 HTML 页 面 文件 来 
响应 客户 端的 HTTP 请 求 。 此 外 ， 当 服务 端 与 客户 端 建立 套 接 字 连接 时 ,服务 端 会 
向 客户 端 发 送 一 个 内 容 为 “Counting ...” 并 且 标 记 了 news 事件 的 消息 。 


当 服 务 端 收 到 echo 事件 时 , 它 则 会 提取 事件 中 包含 的 文本 信息 ,并 增加 计数 融 值 。 
该 计数 占 保 存在 服务 端 应 用 程序 中 ， 当 接收 到 echo 事件 后 会 被 递增 。 当 计数 需 到 
达 50 时 ， 服 务 端 将 不 再 给 客户 问 返 回 数据 。 示 例 13-2 包含 了 服务 端 应 用 程序 的 源 
代码 。 


示例 13-2 Socket.IO MA: 服务 端 应 用 程序 


var app = require('http').createServer(handler) 
, io = require('socket.io').listen(app) 
, fs = require('fs') 


var counter; 
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app.listen(8124); 


function handler (req, res) { 
fs.readFile( dirname + '/index.html', 
function (err, data) { 
if (err) { 
res.writeHead(500) ; 
return res.end('Error loading index.html’); 


} 
counter = 1; 
res.writeHead(200); 
res.end(data); 
})3 
} 
io.sockets.on('connection', function (socket) { 
socket.emit('news', { news: ‘world’ }); 
socket.on('echo', function (data) { 
if (counter <= 50) { 
counter++; 
data. back+=counter; 
socket.emit('news', {news: data.back}); 


} 
}); 


FEIB ATE Pg ARS i BB a, FP a EA hl ar BRE Bo E LRE 
面 看 到 计数 顺 值 不 停 更 新 ,直到 到 达 目 标 值 。 该 Socket.IO 应 用 程序 在 所 有 现代 浏览 
器 上 都 具有 相同 的 行为 ， 尽 管 在 不 同 浏 览 硕 上 使 用 的 底层 技术 实现 可 能 不 一 样 。 


news 和 echo 都 是 自 定 义 事件 。 在 新 的 套 接 字 连 接 建 立时 ，S$ocket.IO 对 象 还 会 收 到 
connection 事件 。 另 外 ， 服 务 端 socket 对 象 还 支持 如 下 事件 : 


message 
每 当 收 到 通过 socket.send 发 送 的 消息 后 会 被 触发 。 
disconnect 
Be FA aig BC ARF a TIT T fh AZ 0 
此 外 ， 客 户 端 socket 对 象 支持 的 事件 列表 如 下 : 
connect 
在 建立 好 套 接 字 连接 后 触发 。 


connecting 


在 尝试 建立 连接 时 触发 。 
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disconnect 

当 套 接 字 连接 断 开 时 触发 。 
connect failed 

建立 连接 失败 时 触发 。 
error 

发 生 错误 时 触发 。 
message 

收 到 通过 socket.send 发 送 的 消息 时 触发 。 
reconnect failed 

Socket.1O 重建 连接 失败 时 触发 。 
reconnect 

断 开 的 连接 被 重新 建立 后 时 触发 。 
reconnecting 

尝试 建立 断 开 的 连接 时 触发 。 


如 果 你 想 控 制 WebSockets 的 行为 , 那么 可 以 使 用 send 代替 emit 发 送 消 息 , 并 监听 
message 事件 。 例 如 , 在 服务 器 上 应 用 程序 可 以 使 用 send 发 送 消息 到 客户 端 , 然后 
通过 监听 message 事件 获取 客户 端的 啊 应 : 


io.sockets.on('connection', function (socket) { 
socket.send("All the news that's fit to print"); 
socket.on('message', function(msg) { 
console.log (msg); 
} ) ; 
}); 


在 客户 端 , 应 用 程序 也 可 以 监听 message 事件 , 并 使 用 send 发 送 消息 与 服务 端 通信 : 


socket.on('message', function (data) { 
var html = '<p>' + data + '</p>'; 
document.getElementById("output") .innerHTML=html; 
socket.send('OK, got the data"); 

}); 
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在 上 面 的 示例 中 ， 客 户 端 使 用 了 send 方法 来 手动 确认 消息 的 接收 。 如 果 布 望 客户 
端 在 接收 到 事件 后 能 自动 应 答 ， 我 们 可 以 为 emit 方法 传递 一 个 回调 冰 数 作为 它 的 
最 后 一 个 参数 : 
io.sockets.on('connection', function (socket) { 
socket.emit('news', { news: "All the news that's fit to print” }, 
function(data) { 
console.log (data); 


} ); 
})? 


ERP, BEAT AEAN Ey eR BOK I WR AS Ha [] — ZR A 


socket.on('news', function (data, fn) { 
var html = '<p>' + data.news + '</p>'; 
document. getElementById ("output") .innerHTML=htm1; 
fn('Got it! Thanks!'); 

DF 


以 参数 形式 传递 给 connection SAFAR RR socket ARZIR SIRS AEA PR ihig 
间 的 一 个 连接 ， 只 要 该 连接 没有 上 断 开 ， 这 个 对 象 就 一 直 存 在 。 当 连接 中 断后 ， 
Socket.IO 还 会 尝试 重新 建立 连接 。 


13.2.2 ”异步 世界 里 的 WebSockets 

在 只 有 一 个 客户 端 时 , 之 前 实现 的 应 用 程序 可 以 正常 工作 。 但 它 的 失败 之 处 在 于 没 
有 考虑 到 Node 的 异步 特性 。 在 应 用 程序 中 ， 计 数 需 是 一 个 全 局 变量 ， 如 果 一 次 只 
有 一 个 客户 访问 应 用 程序 ， 它 工作 得 很 好 。 但 是 ， 如 果 两 个 用 户 在 同一 时 间 访 问 应 
用 程序 , 他 们 就 会 得 到 奇怪 的 输出 结果 : 其 中 一 个 浏 览 锅 中 显示 的 数字 可 能 比 另 外 
一 个 浏览 器 中 的 小 , 而 且 在 这 两 个 浏览 右 中 ,我 们 都 无 法 获得 预期 的 结果 。 当 并 发 
用 户 增多 后 ， 这 个 影响 会 更 明显 。 


因此 , 我 们 需要 一 种 能 将 数据 与 套 接 字 绑 定 的 能 力 , 这 样 数据 与 套 接 字 就 具有 相同 
的 生存 周期 和 作用 范围 。 幸 运 的 是 ,获得 这 种 能 力 并 不 困难 , 我 们 只 需要 在 连接 建 
Wea, 将 数据 直接 写 入 到 socket 对 象 中 即 可 。 示 例 13-3 是 由 示例 13-2 修改 而 来 的 ， 
counter 不 再 是 一 个 全 局 变量 ， 而 是 被 直接 绑 定 在 socket 对 象 上 。 我 用 粗 体 文字 标 
注 了 有 变动 的 代码 。 


示例 13-3 ”将 数据 绑 定 到 套 接 字 
var app = require('http').createServer (handler) 
, io = require('socket.io').listen(app) 
» fs = require('fs') 
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app. listen(8124); 


function handler (req, res) { 
fs.readFile( dirname + '/index.html', 
function (err, data) { 
if (err) { 
res.writeHead(500); 
return res.end('Error loading index.html’); 


res.writeHead(200); 
res.end(data); 
}); 
io.sockets.on('connection', function (socket) { 
socket.counter = 1; 
socket.emit('news', { news: 'Counting...' }); 
socket.on('echo', function (data) { 
if (socket.counter <= 50) { 
data.back+=socket.counter; 


socket.counter++; 
socket.emit('news', {news: data.back}); 


})3 
15 


现在 程序 可 以 支持 多 个 用 户 的 并 发 访问 了 ， 并 且 每 个 用 户 都 能 得 到 完全 相同 的 通信 和 输 
出 信息 。 注 意 ，socket 对 象 会 一 直人 存在 ， 直 到 套 接 字 连 接 被 关闭 或 者 连接 不 能 重建 时 。 


、 警告 
= 由 于 每 个 浏览 器 的 行为 都 不 会 是 完全 一 致 的 , 因此 计数 速度 可 以 快 也 
可 以 慢 ， 这 取决 于 你 所 使 用 的 浏览 器 以 及 用 于 建立 通信 的 底层 机 制 。 


13.2.3 ”天 于 客户 端 代码 
为 了 能 让 Socket.IO E% TE, AP im HFE UHE Socket. IO 提供 的 客户 端 
JavaScript 库 。 通 过 如 下 脚本 元 系 ， 这 个 库 能 被 包含 进 了 页 面 之 中 : 


<script src="/Socket.IO/Socket.IO.js"></script> 
那么 是 否 必 须 将 这 个 库 文件 放 在 Web IRA HET NE? 答案 是 不 需要 。 


在 服务 端 应 用 程序 创建 HTTP Web 服务 骼 对象 后 ， 该 对 象 会 被 传递 给 Socket-IO 
的 listen PAŽI: 


var app = require('http') .createServer (handler) 
, 10 = require ('Socket.IO'). listen (app) 


IKE, Socket.JO 就 可 以 对 所 有 发 送 到 Web 服务 器 的 请 求 进 行 拦截 并 检查 是 否 有 如 
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下 请 求 : 
/Socket.10/Socket.IO.js 


Socket.IO 做 了 一 些 后 台 操 作 来 决定 应 该 为 此 请 求 提 供 什 么 样 的 响应 内 容 。 如 果 客 
vig SCF WebSockets， 返 回 的 文件 将 是 一 个 支持 客户 端 使 用 WebSockets 建立 连接 
的 JavaScript Æ> WRK Pw SCF WebSockets， 但 却 支 持 Forever iFrame (IE9 ), 
它 将 返回 对 应 的 JavaScript 客户 端 代码 ， 并 依 此 类 推 。 


ic He 
-S 不 要 党 试 修 改 这 个 相对 URL， 如 果 你 这 样 做 了 ， 你 的 Socket.IO 应 
用 程序 可 能 无 法 正常 工作 。 


13.3 配置 Socket.IO 


通常 情况 下 我 们 不 需要 修改 Socket IO 的 默认 配置 。 在 之 前 几 节 的 示例 程序 中 ,我 
没有 改变 过 任何 默认 设置 。 不 过 ， 如 果 有 需要 的 话 ， 我 们 可 以 像 在 使 用 Express 和 
Connect 时 一 样 ， 使 用 Socket.IO 的 configure 方法 来 修改 默认 设置 。 TERN 以 为 
应 用 程序 的 各 个 运行 环境 指定 不 同 的 配置 。 


你 可 以 参考 Socket.IO 的 wiki Di (https://github.com/learnboost/Socket-IO/wiki/ ) 
中 罗列 的 所 有 配置 选项 , 我 并 不 会 在 这 里 重复 所 有 这 些 内 容 。 相 反 , 我 只 对 一 些 我 
们 学 习 使 用 Socket.IO 时 可 能 会 用 到 的 配置 项 进行 说 明 。 


你 可 以 通过 transports 选项 来 更 新 可 用 传输 方式 。 默 认 情 况 下 ，Socket.IO 在 选择 传 
输 方 时 采用 的 优先 级 顺序 是 : 


e websocket 

e htmlfile 

e xhr-polling 

e jsonp-polling 


还 有 一 个 默认 情况 下 不 启用 的 传输 选项 是 Flash Socket。 如 果 将 下 面 的 代码 添加 到 
示例 13-3， 那 么 当 我 们 通过 Opera BK TE 浏览 硕 访 问 应 用 程序 时 ， 应 用 程序 将 使 用 
Flash Socket 进行 通信 ( 而 不 是 Ajax long polling 或 Forever iFrame ): 


i0.configure('development', function() { 
io.set('transports', | 
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‘websocket', 
"flashsocket', 
"htmlfile', 
‘'xhr-polling’, 
'jsonp-polling']} 
} ) ; 
你 还 可 以 为 不 同 的 运行 环境 定义 不 同 的 配置 : 


io.configure('production', function() { 
io.set('transports', [ 
"websocket', 
"jJsonp-polling']); 
FI? 
io.configure('development', function() { 
io.set('transports', [ 
"websocket', 
"'flashsocket', 
"htmlfile', 
"xhr-polling', 
'jsonp-polling']); 
] ) ; 


还 有 一 个 用 于 控制 日 志 输 出 信息 等 级 的 配置 项 ( 它 能 将 调试 信息 输出 到 服务 端 控制 
台 )。 如 果 你 想 关 闭 它 ， 可 以 将 log level 选项 设置 为 1: 
io.configure('development', function() { 


io.set('log level', 1); 


1)? 
有 一 些 选 项 不 仅仅 只 是 通过 configuration 方法 配置 后 就 可 以 工作 的 , 它们 还 需要 其 
他 一 些 条 件 ， 例 如 store 配置 项 〈 它 来 决定 客户 端 数据 的 保存 位 置 )。 


一 般 情况 下 , 除 过 log level 和 transports 选项 外 , 我 们 无 需 再 修改 Socket.IO 其 他 配 
置 项 的 默认 值 了 。 


13.4 Chat. WebSockets 版 本 的 "Hello, World” 


每 种 技术 都 有 其 自己 版 本 的 “Hello, World”( 通常 指 人 们 在 学 习 某 项 技术 时 的 首次 
应 用 )， 而 对 于 WebSockets 和 Socket.IO 来 说 , 它 是 一 个 聊天 程序 。 在 Socket.IO 的 
GitHub 站 点 上 还 提供 了 一 些 聊天 客户 端 ( 就 像 一 个 IC， 互 联网 聊天 客户 症 )， 通 
过 搜索 “Socket.IO and chat” 就 可 以 找到 几 个 很 好 的 例子 。 


在 本 节 中 ， 我 将 演示 一 个 很 简单 的 聊天 客户 端 代码 。 它 没有 太 多 功能 ， 只 使 用 了 
Socket.IO ( 并且 客 户 端 或 服务 端 均 没 有 使 用 其 他 库 )， 但 它 演示 了 如何 使 用 
Socket.IO 漂亮 而 优雅 地 实现 一 个 对 于 其 他 技术 来 说 比较 难 实现 的 应 用 程序 。 
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该 应 用 程序 还 使 用 了 Socket.IO 提供 的 另 一 些 方法 。 在 前 面 的 例子 中 ， 我 们 使 用 
Socket.IO 的 send 和 emit 方法 在 客户 端 和 服务 右 之 间 发 送 消 息 进行 通信 。 但 这 类 通 
{APR HITE FERS LE, 无 论 有 多 少 人 同时 连接 在 服务 器 上 , 也 只 有 消息 中 指定 的 
接收 方才 能 看 到 消息 内 容 。 


为 了 将 消息 广播 给 每 个 已 经 连接 到 服务 端的 用 户 ， 你 可 以 在 Socket.IO 框架 对 象 上 
直接 调用 emit 方法 : 


io.sockets.emit (); 


这 样 所 有 与 服务 端 建立 了 连接 的 客户 都 能 收 到 消息 。 你 也 可 以 通过 调用 socket 对 象 
上 的 broadcast.emit 方法 将 消息 广播 给 除 该 socket 以 外 的 所 有 套 接 字 ， 当 然 使 用 该 
socket 对 象 的 用 户 是 无 法 接收 到 这 条 广播 消息 的 : 


socket.broadcast.emit(); 


PT ASP mE Be EY RH is, ACER SHEA FF BER A PAT aR, 

SRR FRG ES AR SS mE ERE A Pig, FRANC AE REA T 
WRZ. Fe Pi Fe HL ett SA a ME RF STA SEA 
还 提供 了 一 块 地 方 用 于 显示 来 自 其 他 用 户 的 新 消息 。 示 例 13-4 是 客户 端 应 用 程序 
的 源 代码 。 


示例 13-4 Chat 程序 客户 端 


<!doctype html> 
<html lang="en"> 
<head> 
<meta charset="utf-8"> 
<title>bi-directional communication</title> 
<script src="/socket.io/socket.io.js"></script> 
<script> 
var socket = io.connect('http://localhost :8124' ); 
socket.on('connect', function() { 
socket.emit('addme', prompt('Who are you?')); 


3 


socket.on('chat',function(username, data) { 
var p = document.createElement('p'); 


p.innerHTML = username + ': ' + data; 
document.getElementById('output' ).appendChild(p) ; 
}); 


window.addEventListener('load',function() { 
document .getElementById('sendtext').addEventListener( click’, 
function() { 
var text = document.getElementById('data').value; 
socket.emit('sendchat', text); 
}, false); 
}, false); 
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</script> 
</head> 
<body> 
<div id="output"></div> 
<div id= send > 
<input type="text" id="data" size="100" /><br /> 
<input type="button" id="sendtext" value="Send Text" /> 
</div> 
</body> 
</html> 


相 比 前 面 的 例子 ， 除 了 增加 基本 的 JavaScript 代码 来 捕捉 按钮 单 击 事件 以 及 得 到 用 
户 名 字 外 ， 其 他 的 功能 没有 太 大 的 不 同 。 


在 服务 端 , 新 接 人 者 的 用 户 名 被 作为 数据 附加 到 了 和 套 接 字 上 。 服 务 闯 会 对 请 求 做 出 
直接 回应 , 然后 将 接 入 者 的 名 字 广 播 给 聊天 室 里 面 的 其 他 参与 者 。 当 服务 端 接 收 到 
任何 新 的 聊天 消息 时 , 会 自动 为 这 条 消息 添加 用 户 名 , 以 便 让 每 个 人 都 能 看 到 是 谁 
发 送 的 这 条 信息 。 最 后 ， 当 客户 端 连接 从 聊天 室 断 开 时 , 男 一 条 消息 会 被 广播 到 当 
前 依然 与 服务 端 保 持 连 接 的 所 有 用 户 ， 以 表明 这 个 人 不 再 参与 聊天 。 示 例 13-5 是 
服务 端 应 用 程序 的 完整 源 代码 。 


示例 13-5 Chat FERRARA ii 


var app = require('http').createServer (handler) 
, io = require('socket.io').listen(app) 
, fs = require('fs'); 


app. listen(8124) ; 


function handler (req, res) { 
fs.readFile( dirname + '/chat.html', 
function (err, data) { 
if (err) { 
res.writeHead(500) ; 
return res.end('Error loading chat.html'); 


ee eee 
res.end(data); 
})5 
} 


io.sockets.on('connection', function (socket) { 


socket.on('addme',function(username) { 
socket.username = username; 
socket.emit('chat', 'SERVER', "You have connected’); 
socket. broadcast.emit('chat', 'SERVER', username + ' is on deck'); 


}); 
socket.on('sendchat', function(data) { 


io.sockets.emit('chat', socket.username, data); 


}}3 
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socket.on('disconnect', function() { 
io.sockets.emit('chat', ‘SERVER’, socket.username + ' has left the building’); 


lak: 
H: 


我 使 用 plete as (Chrome, FireFox, Opera 和 IE) 来 测试 应 用 程序 ， 得 
到 了 图 13-1 所 示 的 运行 结果 。 


iv， RR 
A bi-dire Et al communicat: 


要 CG examples. ee net? 


SERVER- Yona] O bi-directiona! communication - Opera 

File Edit View Bookmarks Chat Tools Help 
SERVER: ene P E EE 

$ ~ meto 


Chrome: Hev, Fi e + 9 i bi-directional communication 


Firefox: IE, nice © 


IE: | like a good ; ood | , 
Opera gr yos oo anhe aa dit | 
Send Taxt || 





i 
| 
| 





13-1 在 不 同 浏览 器 中 测试 基于 Socket.IO 的 聊天 程序 


我 们 还 可 以 再 改进 下 这 个 聊天 程序 , 例如 为 其 添加 用 户 列表 , 以 便 新 加 入 聊天 室 的 
用 户 可 以 看 到 当前 已 经 有 谁 在 线 了 。 这 可 能 需要 一 个 全 局 数组 , 因为 它 与 用 户 名 不 
同 ， 需 要 被 所 有 客户 端 共 享 并 访问 。 不 过 , 我 打算 将 这 个 功能 实现 作为 课 后 练习 作 
业 留 给 你 。 


13.5 # Express 中 使 用 Socket.lO 


之 前 的 示例 程序 一 直 在 使 用 Node 提供 的 HTTP Web 服务 。 其 时 ， 我 们 还 可 以 同时 
使 用 Express 和 Socket.IO。 关 键 是 要 记 住 Socket.IO 必须 要 先 于 Express 侦 听 到 用 户 
请 求 并 处 理 它 。 


我 修改 了 上 一 节 的 聊天 程序 , 让 它 使 用 Express 来 处 理 所 有 Web 服务 请 求 , 得 到 了 
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示例 13-6 的 代码 。 有 关 Socket.1O 和 Express 整合 的 关键 代码 已 经 用 粗 体 标识 了 出 
来 。 另 外 ， 我 没有 对 示例 13-5 的 代码 做 任何 修改 。 


示例 13-6 Chat 程序 的 Express 实现 


var express = require('express'), 
sio = require('socket.io'), 
http = require('http'), 
app = express(); 


var server = http.createServer (app); 


app.configure(function () { 
app.use(express.static( dirname + '/public')); 
app.use(app.router) ; 
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app.get('/', function (req, res) { 
res.send('hello'); 


}); 
var io = sio.listen(server); 
server.listen(8124); 
io.sockets.on('connection', function (socket) { 


socket.on('addme',function(username) { 
socket.username = username; 
socket.emit('chat', 'SERVER', ‘You have connected’); 
socket. broadcast.emit('chat', 'SERVER', username + ' is on deck’); 


H: 


socket.on('sendchat', function(data) { 
io.sockets.emit('chat', socket.username, data); 


}); 


socket.on('disconnect', function() { 
io.sockets.emit('chat', 'SERVER', socket.username + ' has left the building'); 


}); 
})5 
Express 对 象 被 传递 给 了 HTTP server WA, i HTTP server 对 象 又 被 传递 给 了 


Socket.IO 对 象 。 三 个 模块 协同 工作 确保 了 所 有 用 户 请 求 (包括 Web 请 求 或 是 聊天 
通信 数据 ) 都 能 被 正确 处 理 。 


由 于 chat 应 用 客户 端 是 一 个 静态 页 面 ， 所 以 引入 模板 也 是 比较 容易 的 事 。 不 过 需 
要 注意 的 是 负责 与 服务 端 通信 的 脚本 块 需要 被 包含 在 模板 文件 中 ,同时 还 要 保证 引 
用 Socket.IO 库 的 连接 也 存在 于 模板 文件 中 。 


WebSockets 和 Socket.IO 283 


第 14 章 


Node 应 用 程序 的 测试 和 调试 。 


在 之 前 的 章节 中 , 我 们 唯一 使 用 过 的 调试 手段 就 是 在 例子 中 打印 信息 到 控制 台 。 对 
于 功能 简单 的 小 型 程序 的 开发 过 程 来 说 这 种 方法 暂且 可 行 。 但 是 当 程序 规模 逐渐 变 
大 ， 功 能 逐渐 复杂 ， 你 需要 另外 一 种 更 有 效 的 调试 工具 。 


同样 ， 你 可 能 也 需要 更 正规 一 点 的 测试 ， 比 如 使 用 一 些 创 建 测试 的 工具 , 也 可 用 其 
他 人 员 在 自己 的 环境 中 测试 你 所 编写 的 模块 或 者 程序 。 


14.1 调试 


坦白 地 说 ，console.log 一 直 是 我 进行 调试 时 的 一 个 选择 ， 但 是 当 程 序 的 规模 和 复杂 度 都 
快速 增长 时 , console.log 就 显得 无 能 为 力 了 。 一 旦 你 的 程序 具有 一 定 规模 和 复杂 的 功能 ， 
你 就 该 考虑 使 用 更 复杂 的 调试 工具 。 接 下 来 我 们 会 介绍 一 些 可 用 的 调试 工具 以 供 选 择 。 


14.1.1 Node.js Debugger 


V8 引擎 内 建 的 debugger 可 用 于 调试 Node 程序 .Node 同时 提供 了 客户 端 简化 使 用 。 
我 们 在 代码 中 希望 打 断 点 的 地 方 添加 debugger 语句 : 


// 创建 proxy， 监 听 所 有 请 求 
httpProxy.createServer (function (req, res, proxy) { 
debugger; 
if (req.url.match (/*\/node\//) ) 
proxy.proxyRequest (req, res, { 
host:'localhost', 
port:8000 
] ) 7 
else 
proxy.proxyRequest (req, res, { 
host: 'localhost', 
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port:8124 


}); 
}).listen (9000); 


接 下 来 以 debug 模式 运行 程序 : 
node debug debugger.js 


在 debug 模式 中 ， oe ee 输入 cont 或 者 缩写 c 可 以 运行 到 第 一 个 
朵 点 ， 程 序 会 停 在 第 一 个 断 点 处 ， 等 竺 用 户 的 输入 《比如 Web request ): 


<debugger listening on port 5858 
connecting... ok 
break in app2.js:1l 


1 var connect = require('connect'), 
2 http = require('http'), 
3 fs = regquire('fs'), 


debug>cont (--> note it is just waiting at this point for a Web request) 
break in app2.js:11 


9 httpProxy.createServer (function(req,res,proxy) { 
10 


11 debugger; 

12 if (req.url.match(/*\/node\//) ) 

13 proxy.proxyRequest (req, res, { 
debug> 


在 断 点 处 你 有 几 个 选择 。 输 入 n (next) 命令 跳 到 下 一 行 代码 ，o (out) 跳出 一 个 
函数 。 在 以 下 代码 中 ，debugger 停 在 断 点 处 ， 接 下 来 的 几 行 会 通过 next 命令 跳 过 


直到 13 47, HHR REH step 进入 少数 体内 部 。 然 后 可 以 用 next 遍历 果 数 内 
部 代码 ， 再 使 用 out 返回 程序 : 


debug>cont 
break in app2.js:11 
9 httpProxy.createServer (function(reg,res,proxy) I 
10 
11 debugger; 
12 if (req.url.match(/*\/node\//) ) 
13 proxy.proxyRequest (req,res, { 
debug> next 
break in app2.js:12 
10 
Ti debugger; 
12 if (req.url.match(/*\node\//) ) 
13 proxy.proxyRequest (req,res, { 
14 host: “locathost’, 
debug> next 
break in app2.js:13 
11 debugger; 
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12 if (req.url.match(/*\/node\//) ) 


I3 proxy.proxyRequest (req, res, { 
14 host: 'localhost', 
15 port: 8000 


debug> step 
break in /home/examples/public_html/node/node_modules/http-proxy/lib/ 
node-http-proxy/routing-proxy.js:144 


142-77 

143 RoutingProxy.prototype.proxyRequest = function (req, res, options) { 
144 options = options || {}; 

145 

146 // 


debug> next 

break in /home/examples/public_html/node/node_modules/http-proxy/1lib/ 
node-http-proxy/routing-proxy.js:152 

150 // proxyRequest 参数 

151 tf 

152 if (this.proxyTable&& !options.host) { 

153 location = this.proxyTable.getProxyLocation (req); 


154 

debug> out 

break in app2.js:22 

20 port: 8124 
21 } ) ; 

22 }).listen(9000) ; 

2 


24 // 为 动态 资源 的 请 求 添加 路 由 


你 还 可 以 添加 新 的 断 点 , 用 setBreakpont(sb) 设 置 断 点 在 当前 行 , 也 可 以 在 命名 函数 
或 者 脚本 文件 的 第 一 行 : 


break in app2.js:22 


20 port: 8124 

21 }); 

22 }).listen(9000); 

23 

24 // 为 动态 资源 的 请 求 添加 路 由 
debug>sb () 

17 else 

18 proxy.proxyRequest (req,res, { 

19 host: 'localhost', 

20 port: 8124 

Zu }) ; 

*¥22}).listen (93000); 

23 

24// 为 动态 资源 的 请 求 添加 路 由 


25 crossroads.addRoute('/node/{id}/', function(id) { 
26 debugger; 
27 })? 
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使 用 clearBreakpoint (cb) 清除 断 点 。 


除了 使 用 REPL 来 查看 变量 值 , 你 可 以 在 watch 列表 中 添加 表达 式 或 者 列 出 当前 查 
看 的 内 容 : 


break in app2.js:11 
9 httpProxy.createServer (function(reg,res,proxy) { 


10 
11 debugger; 
12 if (req.url.match(/*\/node\//) ) 
13 proxy.proxyRequest (req, res, { 
debug>repl 
Press Ctrl + C to leave debug repl> 
req.url 
'/node/174' 
debug> 

backtrace 命令 可 用 于 打印 当前 执行 栈 的 回溯 ( backtrace ): 
debug>backtracke 


#0 app2.js:22:1 
#lexports.createServer.handler node-http-proxy.js:174:39 


任何 时 候 都 可 以 使 用 help 来 查看 可 供 使 用 的 命令 : 


debug> help 

Commands: run (r), cont (c), next (n), step (s), out (o), backtrace (bt), 
setBreakpoint (sb), clearBreakpoint (cb), watch, unwatch, watchers, repl, 
restart, kill, list, scripts, breakpoints, version 


虽然 内 建 的 调试 工具 很 有 用 ， 但 是 有 时 候 你 需要 的 不 仅仅 如 此 。 你 还 有 其 他 选择 ， 
比如 通过 命令 行 参数 --debug 直接 访问 V8 调试 工具 : 


node --debug app.js 


这 建立 了 一 个 到 debugger 的 TCP 连接 ， 你 可 以 在 命令 行 提示 符 中 输入 V8 调试 的 
命令 。 这 是 个 很 有 意思 的 做 法 ， 但 是 要 求 对 V8 debugger 的 工作 原理 有 一 定 的 理解 
(以 及 有 哪些 命令 可 以 使 用 )。 


为 一 种 选择 是 通过 WebKit 浏览 硕 进 行 调 试 ， 通 过 类 似 Node Inspector 的 程序 ， 将 
在 下 一 节 中 介绍 。 


14.1.2 使 用 Node Inspector 的 客户 端 调试 
Node Inspector 在 开始 调试 前 需要 一 些 设置 ,但 是 磨 刀 不 误 砍 柴 工 嘛 。 


首先 ， 全 局 安装 Node Inspector: 
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npm install-g node-inspector 


为 了 使 用 该 功能 ， 首 先 需要 用 V8 debugger 参数 运行 程序 : 


node--debug app.js 


接 下 来 你 需要 运行 Node Inspector， 前 端 或 者 后 端 运行 都 可 以 : 


node-inspector 


程序 启动 之 后 ， 你 会 看 到 以 下 信息 : 


node-inspector 
info - socket.io started 
visit http://0.0.0.0:8080/debug?port=5858 to start debugging 


使 用 基于 WebKit 的 浏览 器 (Safari 或 者 Chrome ) 打开 调试 页 面 。 我 的 程序 示例 运 
行 在 本 地 ， 所 以 访问 以 下 URL: 


http://examples.burningbird.net:8080/debug?port=5858 


在 浏览 器 中 ， 打 开 客 户 端的 调试 工具 (开发 工具 套件 的 一 部 分 )， 停 在 第 一 个 断 点 
处 。 现 在 你 可 以 使 用 你 可 能 很 熟悉 的 客户 疹 JavaScript 开发 工具 ， 比 如 执行 几 行 代 
码 或 者 查看 属性 的 但 ， 如 图 14-1 所 示 。 


i» app2js0 A ot : 
(fnction | {exports, requir re, sodu ile, _ Filename, _dirname) { war conmect = require('connect’), i 
http = require('h tp’), 
fs = require('#+ Y, 
crossroads = require(' + Ss 
httpProxy = reduir M nts ipo proxy'), 
_base = | / home /exempl 


eate the proxy that listens for all regu 
¢ etek ieee? createServer(function(reg,res, pia E 


> £ ciiest: Object 
Ime complete: false 
proxy. prox xyRequ > correction: Object 
host: “loca alt 
nr 81243 : 


r proxy: Object 
{4 Freg: Object 
: Pee Object 
compl =e false 
» conneriion: Object 
neaders: œj seine 


2i 2); é nttpversionMaiar: 1 
)) -Listen(se0e); 区 htipyersionMinar: 2 
3% j metrad: GET 
ff add route for req reagabie: true 
名 atria 和 > socket: Object 
#6 cebuge statustode: muli 
trailers: Object 
uz grade: Teise 
ar]: /nede 


Bt tpvers S| ol 2 
menrhort 


27 Ys reada le: true 
26 s 


MA 

oo RM 
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pS. 

a 


23 i 
2% nttp. createsery ver eh “4 » pr rot oo: eta 
32 Gebugg2 

cross roads. par eseln 


dl eg ERRAR E 


36 s? Static file server 
7 htte.createServer| conmect( > 
3 -use{ connect .favicont }) 





14-1 Node 程序 作为 服务 器 ，Chrome 中 运行 Node Inspector 


Node Inspector 是 截止 目前 为 止 最 好 的 调试 服务 器 程序 的 工具 。 当 然 可 以 使 用 命令 
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行进 行 调试 ， 但 是 Node Inspector 可 以 一 次 看 到 所 有 代码 ， 并 可 以 使 用 我 们 熟悉 的 
工具 套件 ， 这 弥补 了 对 Node Inspector 所 做 的 设置 。 


aa 提示 
如 果 你 的 Node 程序 由 云 服 务 提 供 ， 该 服务 一 般 也 会 提供 特有 的 开发 
>O 工具 ， 包 括 调试 工具 。 


14.2 单元 测试 (Unit Testing) 


单元 测试 是 一 种 将 特定 组 件 从 整体 程序 中 分 离 出 来 进行 测试 的 方式 。Node 模块 中 
tests 子 目 录 下 的 很 多 测试 痢 是 单元 测试 ， 而 Node 安装 目录 中 的 test 子 目 录 下 全 都 
是 单元 测试 。 

你 可 以 使 用 npm 运行 模块 的 测试 ， 在 模块 的 子 目 录 中 输入 : 


npm test 


这 条 命令 会 运行 模块 的 测试 脚本 〈 如 果 有 的 话 )。 当 我 在 运行 node-redis 的 测试 脚 
本 时 ， 输 出 的 结果 显示 了 成 功 的 测试 用 例 ， 显 示 如 下 : 
Connected to 127.0.0.1:6379, Redis server version 2.4.11 


Using reply parser hiredis 
- flushdb: 1 ms 


- multi_l: 3 ms 
- multi_2: 9 ms 
- multi_3: 2 ms 
- multi_4: 1 ms 

multi 5: 0 ms 


multi_6: 7 ms 


eval_1:Skipping EVAL_1 because server version isn't new enough. 
ms 


lol 1 | 


watch multi: 0 ms 


这 些 测试 很 多 都 是 用 Assert 模块 创建 的 ， 我 们 会 在 下 一 节 介 绍 。 


14.2.1 Asset 与 单元 测试 

Assertion tests ( 断言 测试 ) 计算 表达 式 的 值 ， 计 算 的 结果 只 可 能 是 true 或 者 false. 
如 果 你 和 希望 测试 一 个 轴 数 调用 的 返回 结果 , 首先 你 可 能 需要 测试 的 是 调用 返回 的 是 
一 个 数组 (第 一 个 断言 )。 如 有 果 数 组 需要 为 一 个 固定 长 度 ， 你 可 以 按 长 度 作 条 件 测 
in (第 二 个 断言 )， 以 此 类 推 。 有 一 个 Node 内 建 的 模块 可 以 完成 这 一 系列 的 断言 
测试 : Assert。 


Node 应 用 程序 的 测试 和 调试 289 


你 可 以 在 程序 中 用 require 引入 Assert 模块 : 


var assert = require('asset'); 


我 们 可 以 通过 了 解 现 有 的 模块 如 何 使 用 Assert 来 学 习 。 以 下 这 个 testjs 中 的 测试 是 
node-redis 安装 目录 中 的 一 个 例子 : 


var name = "FLUSHDB"; 
client.select(test_db num, require string("OK", name)); 


该 测试 使 用 了 一 个 require string AX. require string 2 E — AKA, (E Assert 
模块 的 assert.equal assert.stringEqual 方法 : 


function require _string(str, label) { 
return function (err, results) { 
assert.strictEqual (null, err, "result sent back unexpected error: " + err); 
assert.equal (str, results, label +" "+ str +" does not match "+ results); 
return true; 
bi 
} 


第 一 个 测试 assert.stringEqual， 如 果 Redis 测试 返回 的 err 对 象 不 为 空 则 失败 。 第 二 
个 测试 使 用 assertequal， 如 果 返 回 结果 与 预期 结果 不 相等 则 失败 。 该 晒 数 只 有 当 两 
个 测试 都 成 功 的 情况 下 才能 执行 到 return true 147) 


真正 测试 的 内 容 是 Redis select 命令 是 否 成 功 。 如 果 发 生 了 错误 ， 则 输出 错误 信息 。 
如 果 选 择 的 结果 不 是 预期 得 到 的 结果 , 也 会 输出 错误 信息 , 包括 标识 出 测试 哪里 失 
Ms. 


Node 程序 在 自己 的 模块 单元 测试 中 也 使 用 Assert 模块 。 例 如 ， 一 个 名 为 test-util.jjs 
的 测试 程序 ， 用 于 测试 Utilities 模块 。 以 下 代码 测试 了 isArray 方法 : 


// isArray 

assert.equal(true, util.isArray([])); 

assert.equal(true, util.isArray(Array())); 

assert.equal (true, util.isArray(new Array())); 

assert.equal (true, util.isArray(new Array(5))); 
assert.equal(true, util.isArray(new Array('with', 'some', 'entries'))); 
assert.equal(true, util.isArray (context ('Array') ())); 
assert.equal(false, util.isArray({})); 

assert.equal(false, util.isArray({ push: function () {} }));3 
assert.equal(false, util.isArray(/regexp/)); 
assert.equal(false, util.isArray(new Error) ); 


assert.equal(false, util.isArray(Object.create(Array.prototype) ) ) ; 
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assert.equal 和 assert.strictEqual 都 必须 包含 两 个 参数 : 一 个 是 期 竺 得 到 的 返回 结果 , 一 
个 是 表达 式 计算 的 结果 。 在 之 前 的 Redis 测试 中 ，assert.strictEqual 期 竺 结果 为 null 或 
者 err 对 象 。 如 果 期 望 不 匹配 ， 则 测试 失败 。Node 源 代码 中 的 测试 assert.equalisArray， 
如 果 表 达 式 计算 结果 为 tue， 期 望 得 到 的 结果 也 是 true, assert.equal 方法 成 功 ， 没 
有 任何 输出 一 一 成 功 的 结果 是 沉默 的 。 


但 是 如 果 表 达 式 的 计算 结果 不 是 所 期 竺 的 结果 ，assert.equal TASHLA o WR 
我 对 isArray 测试 中 的 第 一 个 参数 进行 修改 : 


assert.equal(false, util.isArray([])); 
结果 为 : 


node .js:201 


throw e; // process.nextTick error, or 'error' event on first tick 


A 


AssertionError: false == true 

at Object.<anonymous> (/home/examples/public_html/node/chap14/testassert. 
js:5:8) 

atModule._compile (module.js:441:26) 

at Object..js (module.js:459:10) 

at Module.load (module.js:348:31) 

at Function._load (module.js:308:12) 

at Array.0 (module.js:479:10) 

at EventEmitter. tickCallback (node.js:192:40) 
assert.equal 和 assert.strictEqual 方法 还 提供 了 第 三 个 可 选 的 参数 ， 在 失败 时 显示 错 
误 信 息 而 不 是 默认 的 失败 处 理 方式 : 


assert.equal(false, util.isArray([]), 'Test 1Ab failed'); 


这 在 同一 个 测试 脚本 中 运行 多 个 测试 时 可 以 有 效 地 指出 是 哪 一 个 测试 失败 了 。 在 
node-redis 测试 代码 中 可 以 看 到 message 的 使 用 : 


assert.equal(str, results, label +" "+ str + " does not match" + results); 
当 测 试 失 败 捕获 异常 时 会 显示 这 个 message 作为 错误 信息 。 


以 下 这 些 Assert 模块 方法 参数 内 容 都 各 目 不 同 ,但 是 都 接收 与 之 前 方法 同样 的 三 个 
参数 : 


assert.equal 


如 果 表 达 式 结果 与 给 出 结果 不 相等 则 失败 。 
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assert.strictEqual 

如 果 表 达 陈 结 末 和 给 出 结 采 不 严格 相等 则 失败 。 
assert.notEqual 

WIR AIA TAA ASG Hh ARTS 
assert.notStrictEqual | 

如 果 表 达 式 结果 和 给 出 结果 严格 相等 则 失败 。 
assert.deepEqual 

如 果 表 达 式 结果 与 给 出 结果 不 相等 则 失败 。 
assert.notDeepEqual 

如 果 表 达 式 结果 和 给 出 结果 相等 则 失败 。 


最 后 两 个 方法 ，assert.deepEqual 和 assert.notDeepEqual 用 于 处 理 复 杂 对 象 ， 比 如 数 
组 或 者 object。 下 面 这 个 使 用 assert.deepEqual 测试 成 功 : 


assert.deepEqual([1,2,3],[1,2,3]); 
但 是 如 果 使 用 assert.equal 则 会 失败 。 


其 余 的 assert 方法 接收 不 同 参数 。 调 用 assert 方法 ， 传 人 值 和 一 个 信息 ， 等 同 于 调 
用 assert.isEqual, true 作为 第 一 个 参数 ,其 余 两 个 参数 为 表达 式 、 信 息 。 以 下 代码 : 


var val = 3; 
assert (val == 3, 'Equal'); 
等 价 于 : 
assert.equal (true, val == 3, 'Equal'); 
另 一 种 变形 且 等 价 的 方法 为 assert.ok: 
assert.ok(val == 3, 'Equal'); 


assert.fail 方法 抛 出 异常 。 该 方法 接收 四 个 参数 : 值 、 表 达 式 、 信 息 和 一 个 操作 符 ， 
操作 符 用 于 在 抛 出 异常 时 分 隔 值 和 表达 式 。 在 以 下 代码 段 中 : 


CE 
var val = 3; 
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assert.fail(3, 4, 'Fails Not Equal', ‘'=="'); 
} catch (e) { 
console.log(e); 


控制 台 信息 为 : 


{ name: 'AssertionError', 
message: 'Fails Not Equal’, 
actual:3, 
expected:4, 
operator: '=="'} 


assert.ifError 国 数 接收 一 个 值 ， 当 该 值 不 为 false 时 则 抛 出 异常 。 正 如 Node 文档 中 描 
述 的 一 样 ， 这 是 一 个 好 的 测试 ， 对 作为 回调 函数 第 一 个 参数 的 error 对 象 进行 测试 : 


assert.ifError(err); // 只 有 err 值 为 true 时 抛 出 异常 


最 后 一 个 assert 方法 为 assert.throws 和 assert.doesNotThrow。 第 一 个 方法 期 等 有 异 
常 抛 出 ， 第 二 个 则 相反 。 这 两 个 方法 参数 相同 ， 第 一 个 参数 为 一 个 代码 区 块 ， 第 二 
三 个 参数 为 可 选 的 error 对 象 和 message. Error 对 象 可 以 是 一 个 构造 困 数 ， 正 则 表 
达 式 或 者 验证 函数 。 在 以 下 代码 段 中 , 由 于 第 二 个 参数 正则 表达 式 与 错误 信息 不 匹 
配 所 以 输出 错误 信息 : 


aSSert .throws ( 
function () { 
throw new Error("Wrong value"); 
by 
/something/ 
) 
} catch(e) { 
console.log (e.message); 


} 


你 可 以 用 Assert 模块 创建 更 复杂 的 测试 。 使 用 该 模块 的 一 个 主要 限制 在 于 你 需要 
做 很 多 对 测试 的 包装 ,以 防 整个 测试 脚本 不 会 因为 一 个 测试 的 失败 而 失败 。 这 也 是 
为 什么 我 们 可 以 使 用 更 高 级 的 单元 测试 架构 ， 比 如 Nodeunit (下 一 市 介绍 ) 更 派 得 
上 用 处 。 


14.2.2 Nodeunit 与 单元 测试 
Nodeunit 提供 了 编写 多 个 测试 脚本 的 方法 。 编 写 完成 后 ,测试 按 顺 序 进 行 , 测试 运 
行 结果 会 报告 在 同一 个 文件 中 。 在 使 用 Nodeunit 之 前 可 以 用 npm 全 局 安装 : 
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npm install nodeunit-g 


Nodeunit 提供 了 一 个 简单 的 方法 运行 一 系列 测试 而 不 需要 用 try/catch HTAA. 
Nodeunit 支持 所 有 的 Assert 模块 测试 , 并 且 提 供 了 自己 的 方法 来 控制 测试 。 测试 按 
照 测试 用 例 (test case ) 分 组 ， 每 个 测试 用 例 做 为 测试 脚本 的 一 个 对 象 方法 。 每 个 
测试 用 例 有 一 个 控制 (control ) 对 象 ， 一 般 命 名 为 test。 测 试用 例 中 第 一 个 调用 的 
方法 是 test 对 象 的 expect 方法 ,告诉 Nodeunit 该 测试 用 例 中 有 多 少 个 测试 。 而 测 
试用 例 中 调用 的 最 后 一 个 方法 是 test 对 象 的 done WE, 告诉 Nodeunit 测试 用 例 运 
行 完 毕 。 这 两 者 之 间 的 所 有 东西 都 是 实际 的 单元 测试 : 
module.exports = { 
‘Test 1': function (test) { 
test.expect (3); // 三 个 测试 
. // 测试 
test.done(); 


} ， 
ITest 2': function (test) { 
test.expect(1); // 只 有 一 个 测试 
. // 测试 


test.done(); 
}; 
运行 测试 ， 输 入 nodeunit， 之 后 输出 测试 脚本 的 名 字 : 
nodeunit thetest.js 


示例 14-1 是 一 个 小 但 完整 的 测试 脚本 ， 包 含 六 个 测试 ， 由 两 个 测试 单元 组 成 ，Testl 
和 Test2。 第 一 个 测试 单元 运行 四 个 独立 测试 ,第 二 个 测试 单元 包含 两 个 。 调 用 expect 
方法 反映 了 单元 中 包含 多 少 个 测试 。 


示例 14-1 Nodeunit 测试 脚本 ， 两 个 测试 单元 ， 总 测试 数 为 6 个 


var util = require('util'); 
module.exports = { 
'Test 1': function (test) { 


test.expect (4); 

test.equal(true, util.isArray([])); 
test.equal (true, util.isArray(new Array(3))); 
test.equal (true, util.isArray([1l, 2, 3])); 
test.notEqual (true, (1 > 2)); 

test.done(); 


Test 2': function (test) f 


test.expect (2) ; 
test.deepEqual([1, 2, 3], [1, 2, 3]); 
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test.ok('str' === 'str', 'equal'); 
test.done(); 


}; 


Nodeunit 运行 示例 14-1 测试 脚本 的 结果 为 : 


example.js 

v Test 1 

v Test 2 

OK: 6 assertions (3ms) 


每 个 测试 之 前 的 标记 符号 表示 测试 结果 : V 对 号 表示 成 功 ，X 义 号 表示 失败 。 在 这 
个 脚本 中 测试 没有 失败 ， 所 以 没有 错误 信息 或 者 堆栈 信息 输出 。 


提示 
ry 对 于 CoffeeScript 粉丝 来 说 有 个 好 消息 ， 最 新 版 的 Nodeunit 支持 
a CoffeeScript 程序 。 


14.2.3 ”其 他 测试 框架 

除了 前 一 章 讲 到 的 Nodeunit, 对 Node 开发 人 员 来 说 还 有 其 他 几 种 可 用 的 测试 框架 。 
这 些 框架 有 的 相对 于 其 他 一 些 较 容易 上 手 , 但 是 各 有 各 的 优 缺 点 。 下 一 节 , 我 会 介 
绍 其 他 三 个 框架 : Mocha, Jasmine 和 Vows. 


Mocha 
使 用 npm 安装 Mocha: 


npm install mocha -g 
Mocha 被 看 作 是 另 一 个 受 欢 迎 的 测试 框架 Espresso 的 后 续 版 本 。 


Mocha 既 可 以 用 于 浏览 器 ， 也 可 以 用 于 Node 程序 中 。Mocha 允许 通过 done 方法 
进行 异步 测试 ， 尽 管 这 个 方法 在 同步 测试 中 会 被 忽略 挤 。Mocha 可 以 兼容 任何 
assertion 的 代码 库 。 


下 面 是 一 个 Mocha 测试 的 例子 ， 使 用 了 should.js Æ: 


should = require('should') 
describe('MyTest', function () { 
describe('First', function () { 
it('sample test', function () { 
"Hello".should.equal ("Hello"); 
Pe 
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} ) ; 
FIs 


在 运行 该 测试 之 前 需要 安装 should.js: 
npm install should 
然后 运行 测试 : 
mocha testcase.js 
测试 应 该 通过 : 
1 test complete (2ms) 


Jasmine 


Jasmine 是 一 个 行为 驱动 开发 的 框架 ， 可 以 用 于 很 多 不 同 的 技术 ， 包 括 Node 中 的 
node-jasmine 模块 。 可 以 用 npm 安装 node-jasmine: 


Npm install jasmine-node -g 

提示 

注意 一 下 模块 名 : jasmine-node， 而 不 同 于 你 在 本 书 中 看 到 的 一 般 的 
node 模块 命名 格式 node- 模 块 名 (或 者 直接 是 模块 名 )。 





jasmine-node GitHub 目录 下 specs 子 目 录 中 包含 示例 。 和 其 他 大 多 数 测试 框架 一 样 ， 
Jasmine Node 模块 也 接收 done 方法 作为 回调 也 数 允 许 异 步 测试 。 


使 用 jasmine-node 模块 时 有 一 些 对 环境 的 要 求 。 首先 , 测试 必须 在 specs 子 目 录 中 。 
Jasmine-node 模块 是 一 个 命令 行程 序 ， 你 可 以 指定 根 目录 , 但 是 测试 最 好 在 specs 
目录 中 。 


然后 ， 测 试 名 需要 符合 固定 的 格式 。 如 果 测 试 是 由 JavaScript 编写 ， 测 试 文件 名 则 
必须 以 .spec.js 结尾 。 如 果 测 试 由 CoffeeScript 编写 , 文件 名 则 需 以 .spec.coffee 结尾 。 
你 可 以 在 specs 目录 中 添加 其 他 子 目 录 。 当 运行 jasmine-node 时 ， 会 运行 specs H 
录 下 所 有 测试 。 


为 了 具体 说 明 ， 我 创建 了 一 个 简单 的 测试 脚本 ,使 用 Zombie ( 稍 后 介绍 ) 对 Web 
服务 需 发 起 请 求 并 访问 页 面 内 容 。 文 件 命名 为 tst.spec.js， 放 置 在 我 的 开发 环境 中 
的 specs 目录 下 : 


var zombie = require('zombie'); 
describe('jasmine-node', function () { 
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it("should respond with Hello, World!", function (done) { 
zombie.visit ("http://examples.burningbird.net:8124", 


function (error, browser, 
status) { 


expect (browser.text()).toEqual("Hello, World!\n"); 
done (); 


Web 服务 器 是 第 1 章 中 的 内 容 ， 所 做 的 就 是 返回 “Hello, World!” 人 信息。 注意 一 下 
换行 符 ， 如 果 没 有 换行 符 测 试 会 失败 。 
用 以 下 命令 运行 测试 : 
jasmine-node --test-dir /home/examples/public html/node 
运行 结果 如 下 : 


Finished in 0.133 seconds 
1 test, 1 assertion, 0 failures 


测试 成 功 。 


tic A 
_ =A 
“= Jasmine 使 用 path.existsSync, ix ©1444 Node 0.8 的 js.existsSync # 
用 ， 和 希望 不 久 就 会 有 修复 。 


如 果 脚 本 是 由 CoffeeScript 编写 ， 运 行 命令 时 会 添加 -coffee BR: 





jasmine-node --test-dir /home/examples/public_html/node -coffee 


Vows 


Vows 是 男 一 个 行为 驱动 开发 的 测试 框架 ， 相 比 其 他 来 说 ，Vows 有 一 个 优点 : 更 全 面 
的 文档 。 测 试 由 测试 套件 组 成 ， 而 测试 套件 又 由 一 系列 分 批 的 可 执行 的 测试 组 成 。 一 
个 批 次 由 一 个 或 多 个 语 境 (context) 组 成 ， 并 行 执行 ， 并 且 每 个 语 境 都 包含 一 个 主题 
(topic), 最 终 得 到 可 执行 的 代码 。 在 代码 中 的 测试 称 为 vow。Vows 与 其 他 测试 框架 不 
同 的 优点 在 于 更 清楚 地 区 分 开 了 测试 的 内 容 (主题 ) 和 测试 本 身 (vow )。 


我 知道 这 里 的 用 法 有 一 些 特别 ， 所 以 我 们 先 来 看 个 简单 的 例子 以 便 更 好 地 理解 
Vows 测试 框架 是 如 何 工 作 的 。 首 先 ， 需要 安装 Vows: 


npm install vows 


为 了 尝试 Vows， 我 使 用 本 书 之 前 创造 的 simple circle 模块 ， 修 改 其 精度 : 
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var PI = Math.PI; 


exports.area = function (r) { 
return (PI * r * r).toFixed(4); 

J? 

exports.circumference = function (r) { 
return (2 * PI * r).toFixed(4); 

}; 


我 需要 修改 结果 的 精度 ， 因 为 需要 对 结果 在 Vows 程序 中 进行 相等 的 测试 。 


在 Vows 测试 程序 中 ，circle 对 象 就 是 主题 ，area 和 circumference 方法 就 是 Vows。 
这 两 个 都 封装 为 Vows 的 语 境 ( context )。 测 试 套件 为 整个 测试 程序 ，batch 为 测试 
实例 (circle 和 两 个 方法 )。 


示例 14-2 Vows 测试 程序 ， 一 个 batch， 一 个 context， 一 个 topic， 两 个 vows 


Var vows = require('vows'), 
assert = require('assert'); 


var circle = require('./circle'); 
var suite = vows.describe('Test Circle'); 


suite.addBatcnh ({ 

‘An instance of Circle': { 
topic: circle, 
"should be able to calculate circumference': function (topic) { 
assert.equal (topic.circumference(3.0), 18.8496); 
by 
"should be able to calculate area': function (topic) { 

assert.equal (topic.area(3.0), 28.2743); 

} 

} 


}) .run(); 
因为 在 addBatch 方法 末尾 添加 的 run 方法 ， 所 以 运行 Node 程序 就 会 运行 该 测试 : 
node example2.js 
结果 中 应 该 是 两 个 成 功 的 测试 : 
OK » 2 honored (0.003s) 


topic 总 是 一 个 异步 方法 或 者 数值 。 不 用 circle 作为 topic， 可 以 借助 水 数 闭 包 直接 
将 object 方法 作为 topic: 


var vows = require('vows'), 
assert = require ('assert'); 
var circle = require('./circle'); 
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var suite = vows.describe('Test Circle'); 


suite.addBatch ( { 
"Testing Circle Circumference': { 
topic: function () { return circle.circumference; }, 
"should be able to calculate circumference': function (topic) { 
assert.equal (topic(3.0), 18.8496); 
} ， 
by 


"Testing Circle Area': { 
topic: function () { return circle.area; }, 
"should be able to calculate area': function (topic) { 


assert.equal (topic(3.0), 28.2743); 
} 
} 


fy run ¢):2 


在 上 述 代 码 中 ， 每 个 context 都 是 一 个 有 title 的 对 象 : Testing Circle Circumference 
和 Testing Circle Area。 每 一 个 context 中 都 有 一 个 topic 和 一 个 vow。 


你 可 以 创建 多 个 batch， 每 个 batch 包含 多 个 context， 而 每 个 context 可 以 依次 包含 
多 个 topics 和 vows。 


14.3 ”验收 测试 


验收 测试 与 单元 测试 不 同 , 主要 目的 在 于 检查 程序 是 否 满足 用 户 需求 。 单 元 测试 用 
于 确保 程序 强健 〈robust )， 而 验收 测试 用 于 确保 程序 有 效 (useful )。 


验收 测试 一 般 通 过 实际 用 户 设 计 和 实现 的 预定 义 脚本 完成 。 验收 测试 可 以 自动 化 完 
成 一 一 通过 一 些 脚本 , 但 是 脚本 由 工具 目 动 运行 而 不 是 人 力 完 成 。 这些 工具 并 不 能 
完全 满足 验收 测试 的 所 有 需求 ， 因 为 工具 没 办 法 从 主观 角度 进行 度量 (“这 个 网 页 
太 难 用 了 !”)， 也 不 能 精确 定位 那些 由 用 户 操作 驱动 出 来 但 是 很 难 发 现 的 bug, 但 
是 可 以 保证 满足 了 程序 的 需求 。 


14.3.1 Soda 和 Selenium 测试 


如 果 你 想 要 一 个 更 高 层面 的 测试 , 使 用 实际 的 浏览 需 而 不 是 模拟 器 , 并 且 愿 意 支付 
测试 服务 的 费用 ， 你 可 以 了 解 一 下 Selenium, Sauce Labs 和 Node 模块 Sodas 


Selenium 满足 了 开发 人 员 对 目 动 化 测试 工具 的 需求 ,Selenium 由 核心 库 、 一 个 Selenium 
remote control ( RC ) 和 Selecnium 集成 开发 环境 (IDE ) 组 成 。Selenium IDE 是 一 个 Fiefox 
插件 ，RC 是 一 个 Java jar 文件 。Selenium 的 第 一 个 版 本 ( Selenium1 ) 是 基于 JavaScript 
的 ， 这 也 造成 了 这 个 工具 套件 的 问题 : Selenium 拥有 一 切 JavaScript 所 有 的 限制 。 另 一 
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个 自动 化 测试 套件 是 WebDriver, WebDriver 的 出 现 主 要 目的 在 于 解决 Selenium 的 限制 。 
Selenium? 的 开发 正在 进行 中 ， 是 Selenium] 和 WebDriver 的 综合 版 本 。 


Sauce Labs 为 Seleniuml 测试 提供 宿主 。 Sauce Labs 为 应 用 程序 提供 了 多 环境 中 的 多 浏 
览 器 的 测试 ， 比 如 Linux 下 的 Opera, Windows7 的 IE9, Sauce Labs 有 两 个 主要 的 限 
fi]: Xt MAC OS X 的 支持 和 没有 移动 平台 的 测试 环境 。 但 是 ,这 确实 是 一 个 对 应 用 程 
序 的 多 浏览 器 支持 的 测试 方法 ， 比 如 I 玉 ， 如 果 只 有 一 台 机 费 的 时 候 很 难 测试 。 


Sauce Labs 提供 了 多 种 订阅 计划 ， 包 括 一 个 基本 的 人 免费 的 订阅 计划 用 于 尝试 该 服 
务 。 基 本 方案 允许 两 个 并 发 的 用 户 ， 提供 了 每 月 200 分 钟 的 OnDemand ( 处 理 需 资 
源 按 需 供应 ) 和 45 分 钟 Scout 一 一 对 开发 人 员 来 说 足够 进行 尝试 。 该 网 站 目标 人 群 
是 Ruby FRAR, 但 是 你 可 以 使 用 Node 模块 Soda. 


Soda 是 对 Selenium 测试 的 Node 包装 。 模 块 文档 中 使 用 Soda 的 范例 代码 为 : 


var soda = require('soda'); 





var browser = soda.createClient ({ 
host: 'localhost' 
port: 4444, 
url: ‘http://www.google.com', 
browser: ‘'firefox' 


} ); 


browser.on('command', function (cmd, args) { 
console.log(' \xlb[33m%s\x1lb[0Om: %s', cmd, args.join(', ')]; 


} ) ; 


browser. 
chain 
.session() 
.open('/') 
.type('gq', 'Hello World') 
.end (function (err) { 
browser.testComplete(function () { 
console.log('done'); 
if (err) throw err; 
} ) ; 
} ) ; 


这 段 代 码 看 起 来 很 直观 。 首 先 ,你 需要 创建 一 个 训 览 器 对 象 ， 摘 述 需要 打开 哪个 训 
览 器 ， 主 机 名 和 端口 号 ， 以 及 需要 访问 的 网 站 名 。 新 建 一 个 浏览 器 session ， 加 载 
页 面 C), 在 id 为 gq 的 输入 区 域 输入 内 容 。 结 束 后 输出 done 到 console.log， 并 抛 
出 过 程 中 产生 的 任何 异常 。 


你 需要 确保 Java 已 安装 才能 运行 Soda 程序 。 然 后 复制 Selenium RC Java .jar 文件 
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到 你 的 系统 并 运行 : 


java-jar selenium.jar 


Selenium 中 定义 了 使 用 Firefox 浏览 右 ， 所 以 需要 安装 Firefox。 我 的 Linux 系统 中 
并 没有 Firefox, 但 是 Windows 系统 的 笔记 本 很 容易 运行 该 程序 。 看 到 Selenium RC 
运行 过 程 中 浏览 右 窗 口 弹 出 并 消失 是 个 很 有 和 趣 但 是 有 点 烦人 的 过 程 。 


另 一 种 实现 是 使 用 Sauce Labs 作为 远程 测试 环境 ,对 给 定 测试 定义 使 用 哪 一 个 浏览 
器 。 你 需要 先 创建 一 个 账户 ， 然 后 找到 你 的 用 户 名 和 API key。 用 户 名 会 显示 在 最 
上 面 的 工具 条 上 , 你 可 以 在 Account 标签 下 点 击 “View my API Key” 链 接 找 到 API 
key。 在 这 里 你 还 可 以 看 到 你 剩余 的 OnDemand 和 Scout 时 间 (我们 创建 的 测试 程 
序 会 使 用 OnDemand 时 间 )。 


为 了 尝试 远程 测试 ， 我 创建 了 一 个 简单 的 测试 ， 测 试 我 们 在 15 章 中 创建 的 登陆 表 
单 。 登录 表单 有 两 个 文本 框 和 两 个 按钮 。 文 本 框 的 内 容 为 用 户 名 和 密码, 一 个 按钮 
为 Submit ( 提交 按钮 )。 测 试 脚 本 测试 失败 而 非 成 功 ， 所 以 测试 场景 应 该 为 : 
1. 访问 网 站 程序 (http://examples.burningbird.net:3000 ); 
2. 打开 登录 页 面 ( /login ); 
3. 在 用 户 名 处 输入 Sally; 
4. 在 密码 处 输入 badpassword; 
5. 网 页 会 显示 “Invalid Password”. 
这 些 步骤 组 成 示例 14-3 的 测试 。 
示例 14-3 测试 登录 表单 密码 错误 
var soda = require ('soda'); 
var browser = soda.createSauceClient ({ 
'url': 'http://examples.burningbird.net:3000/', 
eea access kerh 
'os': 'Linux', 
"browser': 'firefox', 
'browser-version': '3.', 
'max-duration': 300 // 5 分 钟 


})3 


// 完成 后 的 日 志 信息 


browser.on('command', function (cmd, args) { 
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console.log(' \xlb[33m%s\xlb[Om: %s', cmd, args.join(", ")]; 
} ) ; 


browser 
.chain 
-session() 
.setTimeout (8000) 
.open('/login'") 
.waitForPageToLoad (5000) 
.type(‘'username', ‘'Sally') 
.type('password', 'badpassword') 
.clickAndWait('//input [@value="Submit"] ') 
.-assertTextPresent (}Invalid password') 
.end (function (err) { 
browser.setContext ('sauce:job-info={"passed": ' + (err === null) + 
'}", function () { 
browser.testComplete(function () { 
console.log(browser.jobUr1); 
console.log(browser.videoUrl); 
console.log(browser.logUrl); 
if (err) throw err; 
} ) 7 
Eee 
}); 


在 测试 程序 中 , 浏览 咒 对 象 根据 给 定 的 浏览 器 、 版 本 以 及 操作 系统 创建 ， 本 例 中 是 Linux 
上 的 Firefox 3.x。 注 意 到 浏览 大 的 客户 并 也 有 所 不 同 ，soda.createSauceClient， 而 不 是 
soda.createClient。 在 浏览 种 对 象 中 ， 我 严格 限制 了 测试 时 间 不 超过 五 分 钟 。 访 问 的 网 
站 为 http:/examples.buringbirdnet:3000。 我 们 刚刚 讲 过 了 如 何 获取 用 户 名 和 API key. 


每 一 个 命令 的 问题 都 会 被 日 志 记录 。 我 们 希望 有 日 志 信息 以 便 检 查 回 应 , 查找 失败 
和 异常 情况 : 

// 完成 后 的 日 志 信 息 

browser.on('command', function (cmd, args) { 


console.log(' \xlb[33m%s\xlb[Om: %s', cmd, args.join(", ")); 


Se: 


最 后 才 是 实际 的 测试 。 一 般 来 说 , Wis EEA (这 是 一 个 异步 测试 环境 ), 但 
是 Soda 提供 了 链 式 的 getter 大 大 简化 了 添加 任务 的 过 程 。 第 一 个 任务 是 创建 新 的 session， 
然后 添加 测试 脚本 中 的 每 个 任务 。 最 后 ， 程 序 输出 测试 中 job log. video 的 URL. 
运行 程序 的 输出 结果 为 : 


setTimeout: 8000 
open: /login 
waitForPageToLoad: 5000 
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type: username, Sally 

type: password, badpassword 

clickAndWait: //input [@value="Submit"] 

assertTextPresent: Invalid password 

setContext: sauce: job-info={"passed": true} 

testComplete: 

https: //saucelabs.com/jobs/d70919918067 4dc68ec6338f8b8 6£5d6 
https://saucelabs.com/rest/shelleyjust/jobs/d709199180674dc68ec6338f8b 

86f5d6/results/video.flv 


https://saucelabs.com/rest/shelleyjust/jobs/d709199180674dc68ec6338f8b 
86f5d6/results/selenium-server.log 


你 可 以 直接 访问 结果 ， 或 者 登录 Sauce Labs 查看 你 所 有 测试 的 结果 ， 如 图 14-2 所 示 。 


Test ID: 17ecVc 371084cac8b7080af4c99f3b6 
n Fuut T Tec tr od nib /IR CHILE HE 2 

oo Platform Limux firefox & 

cated (Me May OL 2022 13:21 30 OMT -O500 (Central Daviight : 

| Vien i 

o Sarima Tue Mey 01 2012 13:51:90 GMT-0500 (Central Daylight ! 


ji fue Mav QI ZOL? 1 S22 OME GSE (eri ad Daylight | 
7 ridden * 
让 Fe 
: Duration: $1 seconds 
: Véast lime Ü seconds 
LO Misthilisy: Private [make publie} 
Bund > [fx tas! 
Tags: None ladd some 
Custom 
Data 


Nong edd some! 


| Pass/Fail. Failed 


Status Completed 


: Downloads. Vrieo, Raw Log 


gecKewSrowserSessicon(**firefox", "Att 





14-2 Sauce Labs Selenium core 运行 Soda 测试 的 结果 


正如 之 前 提 到 的 ，Soda 是 Selenium 的 包装 ， 所 以 模块 中 没有 什么 关于 Selenium 命 
令 的 文档 。 你 需要 在 Selenium 官网 上 搜索 相关 命令 ， 并 推测 如 何在 Soda 中 使 用 。 


Ha 提示 


ky Selenium 官网 : http://selenium.org/. 
A 


14.3.2 通过 Tobi 和 Zombie 模拟 浏览 器 

你 可 以 用 Node 模块 模拟 浏览 器 ， 而 不 使 用 其 他 特定 的 浏览 器 。Tobi 和 Zombie 都 
提供 了 这 种 功能 。 使 用 这 些 模 块 的 最 大 的 优点 在 于 你 可 以 在 没有 安装 浏览 器 的 环境 
里 运行 程序 。 在 本 节 中 ， 我 会 简要 介绍 如 何 使 用 Zombie 完成 验收 测试 。 
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首先 ， 用 npm 238 Zombie: 


npm install zombie 


Zombie 与 Soda 类 似 ， 你 可 以 创建 浏览 器 并 且 模拟 用 户 对 浏览 器 的 操作 进行 测试 ， 
并 且 还 支持 链 式 调用 来 解决 租 套 的 回调 问题 。 


我 将 示例 14-3 中 对 登录 表单 的 测试 转换 为 Zombie， 只 是 这 次 使 用 了 正确 的 密码 来 
测试 登录 成 功 ( 用户 会 被 重 定向 到 /admin 页 面 )。 示 例 14-4 中 为 该 验收 测试 的 代码 。 


示例 14-4 用 Zombie 测试 登录 表单 
var Browser = require('zombie'); 
var assert = require('assert'); 


var browser = new Browser (); 


browser.visit ("http://examples.burningbird.net:3000/login', 
function () { 
browser. 
fill('username', 'Sally'). 
fill('password', 'apple'). 
pressButton('Submit', function () { 
assert.equal (browser.location.pathname, '/admin'); 
} ) ; 
EIG 
最 后 的 assert WARD, PrI. Nara F/admin 页 面 ， 当 登录 成 功 
后 才 转 到 这 个 页 面 ， 显 示 测 试 成 功 。 


Ac H 

os A 

几 个 例子 都 依赖 于 Node 模块 jsdom。 但 是 这 个 模块 在 Node 0.7.10 
的 不 稳定 版 本 中 还 有 些 问题 ， 希 望 在 Node 0.8.x 中 被 修复 。 


14.4 性 能 测试 : 基准 问题 和 负载 测试 

一 个 满足 用 户 所 有 需求 的 程序 如 果 性 能 太 差 也 无 法 存活 太 久 。 我 们 需要 对 Node F 
序 进行 性 能 测试 , 特别 是 当 我 们 对 过 程 进行 调整 以 提高 性 能 的 时 候 。 我 们 不 能 只 是 
调整 程序 ， 部 团 到 产品 环境 供用 户 使 用 ， 然 后 由 用 户 发 现 性 能 的 问题 。 


性 能 测试 包含 基准 《Benchmark ) 测试 和 负载 测试 。 基 准 测 试 ， 也 称 为 比较 测试 ， 
会 运行 多 个 版 本 的 程序 来 决定 哪个 版 本 更 好 。 当 你 在 调整 程序 来 改进 和 扩展 时 基本 
测试 则 非常 有 用 。 你 创建 一 个 基准 测试 ， 根 据 变化 运行 ， 并 分 析 结 果 。 


负载 测试 ， 从 男 一 个 角度 ,对 程序 进行 压力 测试 。 你 需要 看 到 当 有 太 多 的 并 发 用 户 
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或 者 有 太 多 对 资源 的 请 求 时 , 在 哪个 点 上 你 的 程序 会 前 省 。 你 希望 持续 驱动 你 的 程 
序 直 到 失败 ， 对 于 负载 测试 来 说 失败 就 是 成 功 。 


有 现成 的 工具 可 以 处 理 这 两 种 性 能 测试 ， 很 受 欢 迎 的 一 个 就 是 ApacheBench 。 
ApacheBench 受 欢迎 的 原因 在 于 任何 朔 有 Apache 的 服务 关上 都 可 以 使 用 ， 而 且 很 
DAR RSS ABI AR EE Apache。ApacheBench 也 是 一 个 易于 上 手 ， 强 大 而 简单 的 测 
ih TA, 当 我 在 犹 光 创建 一 个 静态 数据 库 的 可 重用 的 链接 还 是 创建 一 个 链接 使 用 后 
丢弃 ， 就 用 到 了 ApacheBench 运行 测试 。 


ApacheBench 是 基于 网 站 的 程序 ， 意 味 着 你 需要 提供 URL 而 不 是 程序 名 。 如 果 我 
们 选择 了 Node, 或 者 其 他 应 用 可 以 运行 程序 ( 而 不 只 是 查询 网 站 )， 还 有 男 一 个 命 
令 行 /模块 的 混合 工具 :Nodeload。Nodeload 可 以 与 stats 模块 交互 , 输出 图 形 结果 并 
提供 实时 的 监控 。Nodeload 也 支持 分 布 式 的 负载 测试 。 

提示 

在 之 后 的 几 章 节 中 ， 需 要 对 Redis 进行 测试 ， 如 果 你 还 没有 读 过 第 9 
章 ， 你 可 能 现在 需要 了 解 一 下 了 . 





14.4.1 ApacheBench 基准 测试 


ApacheBench 通常 被 称 为 abb， 之 后 我 们 都 会 使 用 ab 指 代 ApacheBench。ab 是 一 个 
命令 行 工 具 , 允许 我 们 指定 程序 运行 的 次 数 以 及 并 发 用 户 的 数目 。 如 果 我 们 希望 模 
拟 20 个 用 户 访问 一 个 网 站 总 共 100 次 ， 我 们 需要 使 用 以 下 命令 : 


ab -n 100 -c 20 http://somewebsite.com/ 
最 后 一 个 斜 杠 很 重要 ， 因 为 ab 需要 接收 一 个 完整 的 URL， 包 括 路 径 。 
Ab 提供 的 输出 内 容 很 丰富 。 一 个 测试 范例 的 输出 〈 不 包括 工具 定义 ) 如 下 所 示 : 


Concurrency Level: 10 

Time taken for tests: 20.769 seconds 

Complete requests: 15000 

Failed requests: 0 

Write errors: 0 

Total transferred: 915000 bytes 

HTML transferred: 345000 bytes 

Requests per second: 722.22 [#/sec] (mean) 

Time per request: 13.846 [ms] (mean) 

Time per request: 1.385 [ms] (mean, across all concurrent requests) 
Transfer rate: 43.02 [kbytes/sec] received 


Connection Times (ms) 
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Min mean[{+/-sd] median max 


Connect: O 0 Ok 0 4 
Processing: 1 14 15.7 12 283 
Waiting: 1 14 15.7 12 283 
Total: 1 14 15.7 12 283 


Percentage of the requests serverd within a certain time (ms) 


99% 40 
100% 283 (longest request) 


测试 运行 了 15 000%, 10 个 并 发 用 户 。 


我 们 最 感 兴趣 的 几 行 ( 粗 体 表 示 ) 表示 每 个 测试 花费 多 长 时 间 ， 以 及 测试 结束 时 的 
累积 时 间 ( 按 比 例 )。 根 据 输出 ， 每 个 请 求 的 平均 时 间 (第 一 个 Time per request ) 
是 13.846 毫秒。 这 是 平均 每 个 用 户 需 要 等 待 多 长 时 间 来 看 到 浏览 右 回 应 。 第 二 个 
Time per request 是 吞吐 量 ， 可 能 没有 第 一 个 那么 有 用 。 


累积 分 布 显示 了 在 一 个 特定 时 段 请 求 的 处 理 情 况 。 这 意味 着 对 每 一 个 用 户 来 说 , 我 
们 可 以 期 望 网 站 的 响应 时 间 在 12 ERA 283 毫秒 , 大 部 分 的 响应 处 理 少 于 20 毫秒 。 


最 后 一 个 我 们 需要 关注 的 值 为 requests per second, 本 例 中 为 722.22。 这 个 值 某 些 程 
度 上 可 以 预测 应 用 程序 的 规模 ,， 它 告诉 我 们 每 秒 钟 程序 可 以 处 理 的 最 大 请 求 数 , 这 
是 程序 访问 的 上 限 。 然 后 ， 你 需要 在 不 同 的 时 候 和 不 同 的 负载 情况 下 运行 测试 ， 特 
别 是 当 你 在 一 个 同时 提供 其 他 服务 的 系统 上 运行 测试 。 


被 测试 的 程序 由 一 个 监听 请 求 的 Web 服务 器 组 成 ,每 个 请 求 触发 一 次 对 Redis 数据 
存储 的 查询 。 程 序 创建 了 一 个 对 Redis 数据 存储 的 持久 性 连接 ， 在 整个 Node 程序 
的 生命 周期 内 维持 该 连接 。 测 试 程序 如 示例 14-5 所 示 。 

示例 14-5 简单 的 Redis 访问 程序 ， 用 于 测试 稳定 的 Redis 连接 


var redis = require("redis"), 
http = require('http'); 


// 创建 Redis 客户 端 


var client = redis.createClient (); 


client.on('error', function (err) { 
console.log('Error ‘ + err); 
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EI 


// 设置 数据 库 为 1 
client.select (1); 
var scoreServer = http.createServer (); 


// 监听 收 到 的 请 求 


scoreServer.on('request', function (req, res) { 


console.time('test'); 
req.addListener("end", function () { 


varobj = { 
member: 2366, 
game: 'debiggame', 
first_name: 'Sally', 
last_name: 'Smith', 
email: 'sally@smith.com', 
score: 50000 }; 


// 添加 或 者 覆盖 数据 

client.hset (obj.member, "game", obj.game, redis.print); 
client.hset(obj.member, "first_name", obj.first_name, redis.print); 
client.hset(obj.member, "last_name", obj.last_name, redis.print); 
client.hset(obj.member, "email", obj.email, redis.print); 
client.hset(obj.member, "score", obj.score, redis.print); 


client.hvals(obj.member, function (err, replies) { 
if (err) { 
return console.error("error response - " + err); 
} 
console.log(replies.length + " replies:"); 
replies.forEach(function (reply, i) { 
console logit “+ 2° Tr. % + reply); 
} ) ; 
} ) ; 
res.end(obj.member + ' set score of ' + obj.score); 
console.timeEnd('test'); 
}); 
pars 
scoreServer.listen(8124); 


// HTTP 服务 器 关闭 ， 客 户 端 连 接 关 闭 
scoreServer.on('close', function() { 
client.quit(); 

bie 


console.log('listening on 8124'); 


我 很 好 奇 如 果 改 变 程序 中 的 一 个 参数 性 能 会 有 什么 变化 : 从 维持 一 个 稳定 的 Redis 
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连接 改 为 每 次 访问 的 时 候 再 建立 连接 , 并 在 请 求 处 理 完 毕 时 释放 连接 。 这 产生 了 第 


二 个 版 本 的 程序 ， 如 示例 14-6 所 示 。 与 第 一 版 程序 不 同 之 处 由 粗 体 标 出 。 
示例 14-6 修改 程序 ， 非 持久 化 的 Redis 连接 


var redis = require("redis"), 
http = require('http'); 
var scoreServer = http.createServer(); 


// 监听 收 到 的 请 求 


scoreServer.on('request', function (req, res) { 
console.time('test'); 


// 创建 Redis 客户 端 


var client = redis.createClient() ; 


client.on('error', function (err) { 
console.log('Error ' + err); 


}); 


// 设置 数据 库 为 1 


client.select (1); 
req.addListener("end", function () { 
var obj = { 


member: 2366, 
game: 'debiggame', 


first_name: ‘'Sally', 
last _name: ‘'Smith', 
email: 'sally@smith.com', 


score: 50000 }; 


// 添加 或 者 覆盖 数据 


client.hset(obj].member, "game", obj.game, redis.print) ; 


client.hset (obj .member, "first_name", obj.first_name, redis.print) ; 
client.hset(obj.member, "last_name", obj.last_name, redis.print); 


client.hset(obj.member, "email", obj.email, redis.print); 
client.hset(obj].member, "score", obj.score, redis.print); 


client.hvals(obj.member, function (err, replies) { 
if (err) { 


return console.error("error response - " + err); 


console.log(replies.length + " replies:"); 
replies.forEach(function (reply, i) { 
console.log(" "+ i +": " + reply); 
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} ) 3 


res.end(obj.member + ' set score of ' + obj.score); 
client.quit() ; 
console.timeEnd('test'); 
} ) 7 
} ) 7 


scoreServer.listen(8124); 


console.log('listening on 8124'); 
对 第 二 版 程序 运行 ab 测试 ， 相 关 的 测试 结果 如 下 : 


Requests per second: 515.40 [#/sec] (mean) 
Time per request: 19.402 [ms] (mean) 


Percentage of the requests served within a certain time (ms) 

50% 18 

66% 20 

75% 21 

80% 22 

90% 24 

95% 27 

98% 33 

99% 40 
100% 341 (longest request) 


这 些 测试 给 了 我 们 很 好 的 指示 , 持久 化 的 连接 有 助 于 提升 性 能 。 这 在 后 来 的 测试 中 
都 得 到 了 证 实 。 

当 我 用 1 000 个 并 发 用 户 运行 测试 100 000 次 的 时 候 ， 持 久 化 的 Redis 连接 程序 完 
成 了 测试 ， 而 另 一 个 程序 则 失败 了 。 过 多 的 并 发 用 户 等 待 Redis， 而 Redis 开始 拒 
绝 连 接 。 精 确 点 ， 在 程序 朋 溃 之 前 完成 了 67985 个 测试 。 

14.4.2 Nodeload 与 负载 测试 


Nodeload 提供 了 命令 行 工 具 实现 与 ab 一 样 的 测试 ， 但 是 附加 了 很 多 易于 阅读 的 图 
形 结 果 。Nodeload 也 提供 了 一 个 模块 用 于 开发 你 自己 的 性 能 测试 应 用 。 


tite Ae 

a =A 

-S 还 有 一 个 程序 也 成 为 Nodeload， 用 于 构建 Git 代码 库 和 打包 为 zip 
文件 。 为 了 确保 使 用 正确 的 Nodeload， 用 以 下 命令 安装 : 


npm install nodeload-g 
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当 nodeload 全 局 安装 完成 后 ， 你 可 以 在 任何 地 方 访问 该 模块 的 命令 行 版 本 。 命 令 
行 参数 与 ab BU: 


nl.js -c 10 -n 10000 -i 2 http://examples.burningbird.net:8124 


程序 访问 网 站 10 000 次 ,模拟 了 10 个 并 发 用 户 。-i 标识 表示 数据 报告 的 频率 ( 每 
两 秒 ， 而 不 是 默认 的 每 十 秒 )。 参 数列 表 如 下 : 


-n—number 

发 起 的 请 求 数 。 
-c --concurrency 

并 发 的 用 户 数 。 
-t --time-limit 

测试 的 时 间 限 制 。 
-m --method 

使 用 的 HTTP 方法 。 
-d --data 


PUT 或 者 POST 请 求 发 送 的 数据 。 
-r --request-generator 


getRequest 方法 的 模块 路 径 ( 如 果 有 自 定 义 的 )。 


-9 --quiet 

不 显示 过 程 信息 。 
-h --help 

帮助 。 


Nodeload 有 趣 的 地 方 在 于 测试 运行 时 显示 的 动态 图 形 。 如 果 你 访问 测试 服务 器 的 
8000 Mig A ( http://localhost:8000 或 者 通过 域名 )， 你 可 以 看 到 一 个 测试 结果 的 图 形 。 
图 14-3 显示 了 一 个 测试 结 采 的 截屏 。 
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OQ Test Results 
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14-3 ”进行 中 的 Nodeload 测试 结果 的 动态 图 形 


该 图 形 会 作为 测试 结果 的 日 志文 件 , 可 以 随时 访问 。 在 测试 结束 时 ， 显 示 的 总 体 结 
RE ab 非常 类 似 。 一 个 输出 的 例子 如 下 所 示 : 


Server: examples.burningbird.net:8124 
HTTP Method: GET 

Document Path: / 

Concurrency Level: 100 

Number of requests: 10000 

Body bytes transferred: 969977 

Elapsed time(s): 19.59 

Requests per second: 510.41 

Mean time per request (ms): 192.74 


Time per request standard deviation: 47.75 


Percentages of requests served within a certain time (ms) 
Min: 23 
Avg: 192.7 
50%: 191 
95%: 261 
99%: 372 
Max: 452 


如 果 你 想 提 供 自 定义 的 测试 ， 你 可 以 使 用 Nodeload 模块 开发 测试 应 用 。Nodeload 
提供 了 动态 监控 、 图 形 、 数 据 ， 以 及 分 布 式 的 测试 能 力 。 
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aie A 

2 = A 

-S Nodeload 目前 使 用 http.createClient, 7£ Node 0.8.x 的 http.request 中 
已 弃 用 。 尽 管 看 起 来 尚且 可 以 工作 ， 应 该 很 快 就 会 升级 。 


14.5 Nodemon 更 新 代码 


在 本 章 结束 前 ， 我 还 想 再 介绍 一 个 模块 Nodemon。 尽 管 与 测试 或 者 调试 无 关 ， 
Nodemon 是 一 个 很 便捷 的 开发 工具 。 


首先 ， 用 npm EX: 
npm install nodemon 
Nodemon 会 对 你 的 程序 进行 封装 。 可 以 使 用 Nodemon 代替 Node 运行 程序 : 


Nodemon app.js 


Nodemon 在 程序 运行 时 监控 整个 程序 日 录 ， 检 查 文件 是 否 有 过 修改 。 如 果 文 件 变 
动 ，Nodemon 会 重启 程序 使 当前 修改 生效 。 


可 以 传递 参数 给 程序 : 
nodemon app.ks paraml param2 
对 于 Coffee 也 可 以 使 用 该 模块 : 


nodemon someapp.coffee 

如 果 希 望 Nodemon 监控 其 他 目录 而 不 是 当前 目录 ， 使 用 -watch 标志 : 
nodemon--watch dirl --watch libs app.js 

文档 记录 该 模块 还 有 其 他 一 些 参 数 ， 可 以 参考 https://github.com/remy/nodemon。 


提示 
第 16 章 介 绍 了 如 何在 Forever 使 用 Nodemon, Forever 会 在 程序 因为 
某 些 原因 关闭 时 重启 应 用 。 
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安全 及 防护 


Web 应 用 程序 的 安全 性 要 比 限制 人 们 访问 应 用 服务 器 更 加 重要 。 对 安全 性 的 要 求 有 
时 复杂 得 有 点 吓人 。 弟 运 的 是 ， 对 于 Node 应 用 程序 开发 者 来 说 ， 与 安全 相关 的 大 
部 分 组 件 已 经 具备 。 我 们 只 需 在 恰当 的 地 方 和 合适 的 时 间 使 用 它们 。 


在 本 章 中 ， 我 通过 四 个 方面 对 站 点 安全 进行 描述 : 加 密 ( encryption )、 身 份 验证 
( authentication ) 和 授权 ( authorization )、 攻 击 防 范 (attack prevention )， 以 及 沙 箱 
(sandboxing ): 


WE 


用 于 确保 在 互联 网 上 传输 数据 的 安全 性 ， 即 使 它 在 传输 过 程 中 被 截获 。 唯 一 的 可 以 
对 数据 进行 解密 的 接收 机 具备 了 适当 的 认证 (通常 是 一 个 key )。 对 于 需要 保密 存 
储 的 数据 也 可 以 采用 加 密 方法 。 


FU RURBAK 


通常 指 我 们 在 需要 访问 应 用 程序 的 某 些 你 护 区 域 时 ， 需 要 先进 行 登录 操作 。 除 了 通 
过 登录 来 保证 一 个 人 可 以 访问 应 用 程序 的 茶 些 区 域 (授权 ) 外 ,还 需要 确保 这 个 人 
就 是 他 目 己 所 摘 述 的 那个 人 《认证 )。 


LT HE 
WRH Ge 3S A Fe PT PAB HE FAB Ao Rai BC ZF YC AN E o 
隔离 脚本 ， 使 得 它 只 能 在 一 个 有 限 的 上 下 文 环境 中 工作 ， 而 不 能 访问 系统 资源 。 
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15.1 数据 加 密 


我 们 在 互联 网 上 会 发 送 大 量 的 数据 。 其 中 大 部 分 并 非 关 键 信 息 ， 例 如 ，Twitter 的 更 
新 、 网 页 历史 、 博 客 文章 的 评论 。 不 过 还 有 一 部 分 数据 具有 隐私 性 ,包括 信用 卡 数 
据 、 机 密 电 子 邮件 ,或 访问 服务 融 时 我 们 输入 的 登录 信息 。 为 了 确保 这 些 数据 的 隐 
私 性 ， 特 别 是 在 传输 过 程 中 不 被 禄 取 ， 我 们 就 需要 为 通信 加 密 。 


15.1.1 TSL/ SSL 配置 


我 们 可 以 使 用 SSL (安全套 接 字 层 ，Secure Sockets Layer) 以 及 它 的 升级 TLS ( 传 
输 层 安全 ，Transport Layer Security ) 来 建立 安全 、 防 算 改 的 客户 端 和 服务 端 通信 。 
TSL / SSL 为 HTTPS 提供 底层 加 密 ， 我 将 在 下 一 书 进 行 次 明 。 然 而 ， 在 做 HTTPS 
相关 开发 工作 之 前 ， 我 们 必须 做 一 些 环境 设置 。 


一 个 TSL/ SSL 连接 需要 客户 端 和 服务 器 之 间 进 行 握手 。 在 握手 期 间 ， 客 户 端 ( 通 
常 是 浏览 器 ) 会 让 服务 器 知道 它 支 持 哪 些 安全 功能 。 服务 器 会 从 中 选择 将 在 通信 中 
采用 的 一 些 功能 ， 并 通过 一 个 SSL 证 书 发 送 到 客户 问 ， 该 证 书 中 还 包括 一 个 公共 
密 钥 。 客 户 端 在 确认 证 书 有 效 性 后 ,将 采用 服务 天 提供 的 密 钥 加 密生 成 一 个 随机 数 ， 
然后 将 其 发 送 回 服务 器 。 然 后 ， 服 务 顺 将 使 用 其 私有 密 钥 来 解密 并 得 到 这 个 随机 数 ， 
它 将 被 用 于 建立 客户 端 与 服务 需 的 安全 通信 。 


为 了 使 一 切 可 以 正常 工作 ， 你 需要 同时 生成 公 钥 、 私 钥 以 及 证 书 。 对 于 生产 环境 ， 
证 书 将 由 受信 任 机 构 签署 〈 例如 我 们 的 域名 注册 商 )， 但 在 开发 环境 中 ， 你 可 以 使 
用 一 个 自 签 名 证 书 。 这 会 在 浏览 需 中 生成 一 个 明显 的 警告 信息 ， 不 过 这 不 是 问题 ， 
因为 并 没有 真实 的 用 户 访问 我 们 在 开发 环境 中 的 站 点 。 

我 们 可 以 使 用 OpenSSL 来 生成 这 些 文件 。 如果 你 使 用 的 是 Linux, 它 应 该 已 经 被 安 
装 了 。Windows 则 有 一 个 二 进 制 安装 包 ， 而 苹果 使 用 自己 的 Crypto 库 。 此 处 ， 以 
Linux 环境 设置 为 例 。 


首先 ， 在 命令 行 中 输入 以 下 内 容 : 
openssl genrsa -des3 -out site.key 1024 


该 命令 使 用 Triple-DES 加 密生 成 私 钥 ， 并 以 PEM 增强 型 保密 邮件 ) 格式 保存 ， 
以 便 私 钥 是 ASCII 可 读 的 。 


系统 将 提示 你 输入 一 个 密码 ， 你 会 在 下 一 步 创建 证 书签 名 请 求 ( CSR ) 时 用 
到 它 。 
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生成 CSR 时 ， 你 需要 输入 刚刚 创建 的 密码 。 然 后 还 需要 回答 很 多 问题 ， 包 括 所 在 
国家 (如 US 代表 美国 )、 所 在 州 或 省 、 城 市 名 称 、 公 司 名 称 和 组 织 、 电 子 邮件 地 
址 。 而 其 中 最 重要 的 一 项 是 通用 名 称 ( Common Name )。 你 需要 使 用 站 点 的 主机 名 ， 
例如 burningbird.net 或 yourcompany.com。 它 用 于 承载 服务 应 用 程序 的 主机 名 称 。 
此 处 我 使 用 了 examples.burningbird.net。 


openssl req -new -key site.key -out site.csr 


使 用 私 钥 需要 提供 之 前 的 密码 作为 通行 口令 。 但 如 果 每 次 启动 服务 器 时 就 必须 提供 
口令 , 这 在 生产 环境 中 将 是 一 个 问题 。 在 接 下 来 的 步骤 中 , 你 需要 从 私 钥 中 删除 口 
令 。 首先 ， 重 命名 私 钥 。 


mv site.key site.key.org 


然后 输入 : 


openssl rsa -in site.key.org -out site.key 
如 果 删 除了 口令 ， 请 务必 确保 秘 钥 文件 只 能 对 root 用 户 可 读 ， 以 保证 服务 器 的 安 
全 性 。 
接 下 来 的 任务 是 生成 自 签名 证 书 。 下 面 的 命令 创建 了 一 个 只 有 365 天 有 效 期 
的 证 书 : 

openssl x509 -req -days 365 -in site.csr -signkey site.key -out final.crt 


现在 所 有 需要 的 组 件 已 经 备 齐 ， 可 以 开始 使 用 TLS /SSL 和 HTTPS 了 。 


15.1.2 使 用 HTTPS 


如 果 Web 页 面 需 要 用 户 登 录 或 需要 处 理 信 用 卡 信 息 ， 那 么 最 好 能 支持 HTTPS. 
HTTPS 是 HTTP 协议 的 变种 ， 它 能 与 SSL 相 结合 以 确保 网 站 的 真实 性 和 有 效 性 ， 
还 能 确保 在 传输 过 程 中 对 数据 进行 加 密 ， 以 及 数据 能 完好 到 达 且 没有 任何 算 改 。 


在 Node 应 用 程序 中 添加 HTTPS 支持 与 添加 HTTP 支持 的 过 程 非常 类 似 ， 除 了 
需要 通过 一 个 options 对 象 来 提供 公共 加 密 密 钥 和 签名 的 证 书 。HTTPS ARS AEN 
默认 端口 也 不 同 : HTTP 通常 使 用 80 端口 提供 服务 ， 而 HTTPS 服务 则 使 用 443 
端口 。 


示例 15-1 演示 了 一 个 非常 简单 的 HTTPS 服务 器 。 当 通过 浏览 器 访问 它 时 ,会 得 到 
HelloWorld 信息 。 
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示例 15-1 一 个 简单 的 HTTPS 服务 器 


var fs = reauire("fs"), 
https = require("https"); 


var privateKey = fs.readFileSync(‘site.key').toString(); 
var certificate = fs.readFileSync('final.crt').toString(); 
var options = { 

key: privateKey, 

cert: certificate 


j; 


https.createServer(options, function(req,res) { 
res.writeHead(200); 
res.end("Hello Secure World\n"); 
}).listen(443); 


公 钥 和 证 书 都 是 公开 的 ， 程 序 会 谈 取 他 们 的 内 容 。 然 后 将 这 些 内 容 附 加 到 options 
对 象 中 ， 并 在 调用 https.createServer 方法 时 作为 第 一 个 参数 传人 。 该 方法 的 回调 上 
数 同样 会 接收 服务 端的 request 对 象 和 response 对 象 并 作为 参数 。 


由 于 使 用 了 自 签 名 的 证 书 ， 访 问 页 面 时 会 发 生 一 些 情况 ， 如 网 15-1 所 示 。 这 是 为 
什么 只 有 在 测试 过 程 中 才能 使 用 日 签名 证 书 的 原因 。 











The site's security certificate is not trusted! 


You attemated to reach examples. burningbird.net. but the server presented a 
certificate issued by an entity that is not trusted by your computers operating system. 
This may mean that the serwer has generated its own security credentials, which Geogle 
Chrome cannot rely on for identity information. ar an attacker may be trying to intercept 
your communications 


You should not proceed. especially if you have never seen this warning before for this 


_Proceed anga „Back to safety. 


> Helio me understand 

















图 15-1 FA Chrome 访问 使 用 了 自 签名 证 书 的 HTTPS 网 站 


浏览 器 的 地 址 栏 也 以 另 一 种 方式 显示 了 该 网 站 的 证 书 不 被 信任 ， 如 网 15-2 所 示 。 

通常 显示 一 个 锁 表 示 该 网 站 是 通过 HTTPS 访问 的 ， 现 在 它 显 示 了 一 个 红色 的 带 X 

的 锁 ， 表 示 该 HTTPS 站 点 的 证 书 不 能 被 信任 。 单 击 该 图 标 会 打开 一 个 信息 窗口 ， 
显示 了 有 关 证 书 的 详细 信息 。 
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€ © & bites. ‘examples.burningbird.net 


Hello Secu The identity of this website has not been 
verified. 

« Server's certificate ts not trusted. 
Certificate information 





Peay, Your connection to examples.burningbird.net 
baal is encrypted with 256-bit encryption. 


The connection uses TLS 1.0. 


The connection is encrypted using 

AES 256 CBC, with SHAI for message 
authentication and RSA as the key exchange 
mechanism, 


The connection is not compressed. 


_ Site information 
Se You have never visited this site before today, 





What do these mean? 




















815-2 点 击 锁 图 标 可 以 获取 更 多 证 书信 息 


对 于 Web 应 用 程序 来 说 ， 加 密 不 仅仅 在 通信 时 使 用 ， 在 保存 用 户 名 和 其 他 敏感 数 
据 时 也 会 用 到 。 

15.1.3 ”如 何 安全 的 保存 密码 

Node 提供 了 一 个 名 为 Crypto 的 模块 用 于 实现 加 密 功 能 。 下 面 是 摘自 该 模块 文档 的 
一 段 摘 述 : 

Crypto 模块 依赖 于 OpenSSL 所 提供 的 底层 平台 。OpenSSL 对 安全 认证 进行 了 封装 , 
以 便于 我 们 建立 安全 的 HTTPS 和 HTTP 链接 。 

Crpto 模块 还 对 OpenSSL 提供 的 shash、hmac、cipher、decipher、sign 和 verify 方 
法 进行 了 封装 以 便于 使 用 。 

本 市 会 使 用 的 是 其 中 的 OpenSSLhash 功能 。 

对 于 大 多 数 Web 应 用 程序 来 说 ,保存 用 户 登 录 信 息 及 密码 是 必须 支持 的 一 项 功能 ， 
但 同时 这 项 功能 也 是 最 为 脆弱 的 。 当 用 户 名 和 密码 被 存储 在 Web 应 用 程序 的 纯 文 


本 数据 库 后 , 我 们 可 能 只 需要 花费 五 分 钟 时 间 就 能 破解 并 得 到 登录 信息 , 如果 这 些 
信息 被 泄露 的 话 ， 大 知道 会 市 来 什么 影响 。 
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所 以 ， 你 不 能 将 密码 以 纯 文 本 格式 来 保存 。 辛 运 的 是 ,我 们 可 以 使 用 Node 提供 的 
Crypto 模块 。 


Crypto 模块 的 createHash 方法 可 以 用 来 加 密 密 码 。 在 下 面 的 例子 中 ， 我 们 首先 创建 
了 一 个 使 用 SHA1 算法 的 hash， 然 后 使 用 该 hash 对 密码 进行 编码 ， 最 后 再 提取 加 
密 数 据 摘要 并 将 其 保存 在 数据 库 中 : 


Var hashpassword = crypto.createHash('shal') 
. update (password) 
.digest ("hex"); 


我 们 使 用 的 摘要 编码 格式 为 十 六 进 制 。 上 默认 编码 是 二 进 制 的 ， 也 可 以 使 用 base64 
编码 。 


许多 应 用 程序 都 采用 这 种 方式 来 加 密 密 码 。 然 而 ， 如 果 将 使 用 hash 加 密 后 的 密码 
保存 在 数据 库 的 话 , 也 是 存在 问题 的 ,因为 这 种 密码 容易 通过 彩虹 表 ( rainbow table ) 
来 破解 。 


简单 地 说 ,彩虹 表 是 一 个 针对 各 种 可 能 的 字母 组 合 预 先 计算 好 的 哈 希 值 集合 。 所 以 ， 
即使 有 人 认为 自己 的 密码 不 可 能 被 破解 ( 说 实话 ,我们 大 多 数 人 不 会 这 么 想 ), 但 
如 果 这 段 字 符 序 列 恰好 在 彩虹 表 中 有 对 应 条 目 ， 那么 判断 你 的 密码 就 变 得 非常 容 
多 了 。 


解决 这 个 问题 的 方法 是 使 用 salt,， 并 将 它 与 密码 拼接 然后 再 进行 加 密 计算 。salt (不 
要 以 为 是 那 种 常见 的 晶体 ) 是 我 们 使 用 某 种 方法 生成 的 一 段 唯一 值 。 它 可 以 一 直 不 
AS, 并 在 所 有 密码 加 密 时 使 用 , 但 是 一 定 要 安全 地 保存 在 服务 器 上 。 不 过 更 好 的 办 
法 是 为 每 个 用 户 密码 生成 唯一 的 salt， 然 后 将 其 与 密码 一 起 存储 。 诚 然 ，salt 也 可 
能 与 密码 一 起 被 历 取 , 但 试图 破解 该 密码 的 人 则 需要 单独 为 此 密码 生成 彩虹 表 ， 从 
而 极 大 地 增加 了 破解 的 复杂 性 。 

示例 15-2 是 一 个 简单 的 命令 行 应 用 程序 ， 我 们 需要 为 其 传递 用 户 名 和 密码 作为 参 


Bl, 程序 会 对 密码 进行 加 密 ， 然 后 将 结果 存储 在 MySQL 数据 库 表 中 。 下 面 的 SQL 
用 于 创建 使 用 到 的 数据 库 表 : 


CREATE TABLE user (userid INT NOT NULL AUTO INCREMENT, PRIMARY KEY (userid), 
username VARCHAR(400) NOT NULL, password VARCHAR(400) NOT NULL); 


salt 可 以 通过 将 一 个 日 期 值 乘 以 一 个 随机 数 然后 四 舍 五 2”. 取 整 后 得 到 。 它 与 密码 拼 
接 在 一 起 后 得 到 一 个 字符 串 ， 该 字符 串 将 会 被 用 来 做 加 密 处 理 。 最 终 得 到 的 处 理 结 
果 将 作为 用 户 数 据 插 入 到 MySQL 用 户 表 中 。 
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示例 15-2 使 用 Crypto.createHash 方法 和 salt 来 加 密 密 码 


var mysql = require('mysql'), 
crypto = require('crypto'); 


var client = mysql.createClient({ 
user: ‘username’, 
Password: ‘password ' 


}); 
client.query('USE databasenm'); 


var username = process.argv[2]; 
var password = process.argv[3]; 


var salt = Math.round((new Date().valueOf() * Math.random())) + ''; 


var hashpassword = crypto.createHash('sha512') 
.update(salt + password) 
.digest('hex'); 
// create user record 
client.query('INSERT INTO user ' + 
‘SET username = ?, password = ?, salt = ?', 
[username, hashpassword, salt], function(err, result) { 
if (err) console. log(err); 
client.end(); 
})5 


示例 15-3 的 示例 程序 根据 用 户 名 查询 数据 库 中 的 对 应 的 密码 及 salt， 以 便 测 试用 户 
名 和 密码 的 有 效 性 。 在 程序 中 ， 我 们 再 次 使 用 salt 对 用 户 提供 的 登录 密码 进行 加 密 。 
并 将 加 密 结果 与 存储 在 数据 库 中 的 加 密 数 据 做 比较 。 如 果 二 者 不 匹配 , 则 用 户 不 能 


通过 验证 。 反 之 ,用户 信 息 匹 配 ， 身 份 验证 通过 。 
示例 15-3 验证 用 户 名 和 已 加 密 密 码 


var mysql = require('mysql'), 
crypto = require('crypto'); 


var client = mysql.createClient({ 
user: ‘username’, 
password: ‘password’ 


})5 


client.query('USE databasenm'’ ) ; 


var username = process.argv[2]; 
var password = process.argv[3]; 


client.query('SELECT password, salt FROM user WHERE username = ?', 
[username], function(err, result, fields) { 
if (err) return console.log(err); 


var newhash = crypto.createHash('sha512') 
.update(result[0].salt + password) 
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.digest('hex'); 


if (result[0].password === newhash) { 
console.log("OK, you're cool"); 
} else { 


console.log("Your password is wrong. Try again."); 


client.end(); 
})3 


现在 试 着 运行 一 下 这 些 示 例 程 序 ， 我 们 首先 来 创建 一 条 用 户 信 息 ， 用 户 名 为 
Michael, #444 applef*rk13* : 


node password.js Michael apple*frk13* 
我 们 再 使 用 同样 的 用 户 名 和 密码 进行 验证 : 

node check.js Michael apple*frk13* 
并 获得 现 期 的 结 来 : 

OK, you're cool 

尝试 一 个 不 同 的 密码 

node check.js Michael badstuff 
同样 得 到 了 预期 的 结 末 : 

Your password is wrong. Try again 


当然 , 我 们 并 不 希望 在 真实 情况 下 让 用 户 通过 命令 行 登录 系统 。 同样 也 不 希望 总 是 
使 用 本 地 密码 系统 来 验证 用 户 。 所 以 ， 接 下 来 让 我 们 看 看 Node 对 认证 及 授权 的 
支持 。 


15.2 ”认证 /授权 及 Passport 

你 如 何 证 明 自 己 的 身份 ” 你 有 没有 权限 做 某 项 操作 ?这 个 操作 是 否 会 引起 麻烦 ? 
身份 验证 与 授权 管理 这 两 种 不 同 的 技术 可 以 帮助 我 们 回答 以 上 问题 。 
认证 ( Authentication ) 所 关注 的 是 确保 你 就 是 你 说 的 那个 人 。 当 Twitter 为 账户 附 
加 一 个 验证 标志 时 ， 就 表示 当前 用 户 就 是 其 本 人 。 授 权 ( Authorization ) 则 从 另 一 
方面 确保 你 只 能 访问 你 能 访问 的 。 在 Drupal 站 点 的 众多 用 户 中 ， 可 能 有 一 半 用 户 
有 权限 发 表 评 论 ， 有 五 人 可 以 发 表 文 章 和 评论 , 但 只 有 一 人 可 以 控制 所 有 一 切 。 这 
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个 网 站 并 不 在 乎 名 为 Big Daddy 的 用 户 是 谁 ， 他 只 可 以 发 表 评 论 ， 但 不 能 删 帖 。 


人 们 常常 将 认证 及 授权 作为 一 个 功能 看 待 。 通 币 情 况 下 ， 当 你 符 试 做 一 些 操 作 时 ， 
你 需要 遂 过 一 些 验证 手段 来 证 明 你 是 谁 。 你 可 能 会 被 要 求 提供 用 户 名 和 密码 。 然 后 ， 
一 旦 通过 验证 ， 你 将 可 以 做 更 多 操作 。 但 应 用 程序 依然 会 根据 你 提供 的 认证 信息 来 
限制 你 只 能 访问 某 些 网 页 ， 或 只 能 执行 条 些 操作 。 


有 时 候 认 证 是 通过 第 三 方 完成 的 。 第 三 方 认证 的 一 个 例子 是 使 用 OpenID。 在 支持 
OpenID 的 应 用 程序 中 ， 用 户 将 通过 OpenID 来 验证 身份 并 提供 相应 的 应 用 程序 访 
问 权 限 ， 而 非 通过 其 注册 的 用 户 名 和 密码 。 


有 时 身份 验证 和 授权 都 会 放 在 第 三 方 网 站 进行 。 例 如 ， 如 果 应 用 程序 要 访问 Twitter 
或 Facebook 账户 ( 可 能 为 了 发 布 消息 或 获得 信息 )， 那 么 就 必须 通过 这 些 网 站 的 号 
份 验证 ,你 的 应 用 程序 才能 取得 对 应 的 访问 授权 。 这 种 方式 叫 OAuth, 它 采 用 了 不 
同 的 授权 策略 。 


在 Node 中 ， 使 用 Passport 以 及 一 个 或 多 个 Passportstrategy 模块 就 可 以 文 持 相关 功 
能 并 帮助 我 们 实现 上 述 所 有 场景。 
TEE 
| as Passport 并 不 是 唯一 一 个 提供 身份 验证 和 授权 的 模块 ， 但 我 发 现 它 是 
tad, 


15.2.1 授权 /认证 策略 : Oauth、OpenID、 用 户 名 /密码 验证 
让 我 们 来 仔细 看 看 三 种 不 同类 型 的 授权 /认证 策略 。 


当 你 访问 一 个 内 容 管理 系统 (CMS ， 例 如 Drupal 或 Amazon ) 的 后 台 管 理 部 分 时 ， 
你 需要 使 用 身份 验证 。 此 时 你 需要 提供 用 户 名 和 密码 , 在 这 两 者 通过 网 站 验证 之 前 ， 
你 无 法 获得 访问 权限 。 这 是 使 用 的 最 为 广泛 的 授权 /认证 策略 。 而 且 在 大 多 数 情况 
下 ， 它 也 是 有 效 的 一 种 策略 。 


此 前 的 章节 中 ， 我 演示 了 如 何 让 数据 库 中 保存 的 用 户 密码 更 加 安全 。 即 使 系统 被 攻 
De, 数据 客 贼 也 很 难 取得 以 纯 文本 格式 保存 的 用 户 密 码 。 当 然 ， 他 们 可 以 破解 你 的 
密码 。 但 是 ,如果 你 的 密码 是 一 个 相对 无 境 义 的 ， 而且 是 包含 了 字母 、 符 号 和 数字 
的 组 合 时 ， 破 解 它 就 要 花费 相当 多 的 时 间 和 CPU 资源 了 。 


OAuth 是 一 种 无 需 直 接 使 用 用 户 密 码 来 访问 数据 的 方式 ( 比如 访问 一 个 人 的 Twitter 
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账户 数据 )。 它 是 一 种 数据 访问 授权 方式 ， 用 户 无 需 青 将 个 人 凭据 信息 保存 在 多 个 
不 同 的 地 方 ( 这 样 会 增加 个 人 凭据 被 危害 的 可 能 性 )。 它 也 为 用 户 提 供 了 更 大 的 控 
制 权 ， 因 为 用 户 通常 可 以 随时 从 主 账户 中 撤销 授权 。 


OAuth 主要 用 于 数据 访问 的 授权 。 而 OpenID 则 主要 关注 用 户 身 份 验证 ， 尽 管 也 包 
含 了 一 些 授权 处 理 。 


OpenID 的 使 用 并 没有 OAuth 广泛 ,， 它 主要 用 于 评论 系统 以 及 不 同 媒体 网 站 的 用 户 
注册 。 评论 系统 需要 解决 的 问题 之 一 是 : 任何 人 都 可 以 声称 自己 是 某 个 人 , 但 却 没 
有 办 法 确认 他 就 是 他 说 的 那个 人 。 如 果 使 用 OpenID 的 话 ， 一 个 人 可 以 登录 评论 系 
统 或 注册 用 户 ，OpenID 会 确保 对 这 个 人 的 身份 验证 ， 至 少 在 OpenID 系统 内 是 被 
验证 过 的 。 


OpenID 也 是 一 种 解决 用 户 多 地 注册 的 方案 ， 我 们 无 需 再 为 不 同 的 身份 验证 环境 创 
建 各 自 的 用 户 名 和 密码 。 你 只 要 提供 自己 的 OpenID 给 当前 信息 系统 ， 它 会 从 
OpenID 提供 商 那里 获得 对 你 的 身份 验证 结 末 ， 你 就 大 功 告 成 了 。 


这 三 种 策略 互相 之 间 并 不 冲突 。 许 多 应 用 程序 同时 支持 所 有 三 种 策略 : 通过 本 地 身 
份 验证 来 做 一 些 管理 操作 ， 通 过 OAuth 来 共享 数据 ( 例如 Facebook 和 Twitter ), 
使 用 OpenID 来 支持 用 户 注册 和 评论 。 


在 Node 中 有 许多 模块 可 以 用 来 实现 上 述 所 有 映 份 验证 和 授权 方式 ， 但 我 打算 把 重 
点 放 在 Passport 模块 。Passport 是 同时 支持 Connect 和 Express W—ax P EF, H 
以 提供 身份 验证 和 授权 。 你 可 以 使 用 npm 来 安装 它 : 


npm install passport 


Passport 还 可 以 使 用 一 些 stragey, AUPE APE. HAGA stragey AY, 
有 一 些 基本 要 求 : 


e strategy 必须 被 正确 安装 ; 
e。 ”必须 在 应 用 程序 中 对 strategy 进行 配置 ; 
。 ”作为 配置 的 一 部 分 ，strategy 需要 包括 一 个 用 来 验证 用 户 凭据 的 回调 曙 数 ; 


。 使 用 strategy 所 需要 的 额外 工作 量 取决 于 对 用 户 和 凭据 进行 审核 的 权威 机 构 : 
Facebook 和 Twitter 需要 一 个 账户 及 账户 的 key, M local strategy 需要 保存 有 用 
户 名 和 密码 的 数据 库 ; 


。 所 有 strategy 都 需要 一 个 本 地 数据 存储 区 来 做 授权 机 构 名 称 与 应 用 程序 的 
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上 映射; 
。 直接 使 用 Passport 模块 提供 的 用 户 会 话 保存 功能 。 


在 本 章 中 , 我 们 会 使 用 两 种 Passportstrategy, 分 别 用 于 本 地 认证 和 授权 , 以 及 Twitter 
的 OAuth 认证 授权 。 


15.2.2 Local Passport Strategy 
我 们 可 以 使 用 npm 安装 Local Passport Strategy 模块 passport-local ): 


npm install passport-local 


Passport 是 中 间 件 ， 因 此 在 使 用 前 必须 与 其 他 Express 中 间 件 一 样 被 实例 化 。 首 先 
需要 在 代码 中 包含 passport 和 passport-local 模块 : 


var express = require('express'); 
var passport = require('passport'); 
var localStrategy = require('passport-local') .Strategy; 


使 用 下 面 的 代码 局 用 Passport 中 间 件 : 


var app = express(); 
app.configure (function () { 


app.use(passport.initialize()); 
app.use(passport.session()); 


}); 


接 下 来 需要 配置 local strategy。 与 配置 其 他 strategy 所 采用 的 格式 是 一 致 的 : 需要 
使 用 use 方法 将 一 个 strategy 的 新 实例 传递 给 Passport ， 这 和 在 Express 中 使 用 
Passport 模块 的 方式 很 类 似 : 


passport.use(new localStrategy( function (user, password, done) { ... } 


passport-local 模块 期 望 用 户 的 账户 信息 (用 户 名 和 密码 ) 是 以 Post 表单 的 形式 传递 
到 Web 应 用 程序 ， 并 且 用 户 名 和 密码 的 具体 值 应 该 被 保存 在 名 为 username 和 
password 的 字段 中 。 如 果 你 想 为 用 户 名 和 密码 使 用 其 他 字段 名 称 ， 则 需要 在 创建 
strategy 实例 时 将 字段 名 称 作 为 可 选项 传人 : 


var options = 
{ usernameField : 'appuser', 
passwordField : 'userpass' 
be 


passport.use (new localStrategy (options, function (user, password, done) {... } 
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在 从 请 求 中 提取 了 用 户 名 和 密码 后 ， 传 递 给 strategy 构造 旺 数 的 回调 函数 会 被 调用 。 
我 们 需要 在 该 函数 中 实现 身份 验证 人 逻辑 ， 并 返回 如 下 值 : 


e 一 个 error， 如 果 发 生 错 误 的 话 ; 
。 一 条 信息 ， 如 果 用 户 身 份 验 证 失败 ，; 
e user 对 象 ， 如 果 用 户 通 过 身份 验证 ; 


每 当 用 户 试 图 访问 站 点 的 受 保 护 区 域 ，Passport 都 会 查询 该 用 户 是 否 已 经 被 授权 。 
在 下 面 的 代码 中 ， 当 用 户 试图 访问 受 限制 的 管理 页 面 时 ， 一 个 名 为 ensure 
Authenticated 的 果 数 将 会 被 调用 ， 以 确定 用 户 是 否 被 授权 : 

app.get('/admin', ensureAuthenticated, function(reg, res) { 


res.render('admin', { title: 'authenticate', user: req.user }); 


} ) ;? 


ensureAuthenticated KAAKA req.isAuthenticated 方法 的 返回 值 ， 它 是 Passport 为 
request 对 象 增加 的 一 个 扩展 方法 。 如 果 该 方法 返回 false， 当 前 用 户 的 访问 将 被 重 
定 回 到 登录 页 面 : 
function ensureAuthenticated(req, res, next) { 
if (regq.isAuthenticated()) { return next(); } 


res.redirect('/login') 


} 
为 了 使 登录 状态 能 够 在 一 个 会 话 中 保持 有 效 , Passport 提供 了 两 个 方法 : serializeUser 
和 deserializeUser。 我 们 必须 在 这 两 个 方法 的 回调 机 数 中 实现 相关 功能 。 简 单 来 说 ， 
passport.serializeUser 会 序列 化 用 户 标 识 符 ， 而 passport.deserializeUser 则 使 用 标识 
和 从 在 数据 存储 中 进行 查找 ， 并 返回 一 个 包含 用 户 详细 信息 的 对 象 : 


passport.serializeUser(function(user, done) { 
done (null, user.id); 
2E 


passport .deserializeUser (function (id, done) { 

D 
在 Passport 中 ,序列 化 并 不 是 必须 的 。 如 果 你 不 想 序 列 化 用 户 信 息 ， 只 要 不 在 代码 
中 使 用 passport.session 中 间 件 即 可 : 


app.use(passport.session()); 


如 采 你 决定 要 序列 化 并 将 用 户 信息 保存 在 会 话 中 (你 也 应 该 这 样 做 ,否则 用 户 会 因 
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为 不 断 地 收 到 登录 请 求 而 非常 恼火 )， 则 必须 确保 Passport 中 间 件 被 包含 在 代码 中 ， 

并 且 放 在 包含 session 中 间 件 的 代码 之 后 : 
app.use(express.cookieParser('keyboard cat')); 
app.use(express.session()); 


app.use(passport.initialize()); 
app.use(passport.session()); 


MRNA RERE KERIA, BEREAN BE IE HY LIF o 


Ba A Se e DREE A SE EAT EAEE, MR 
个 用 户 的 用 户 名 没有 在 数据 存储 中 被 搜索 到 ， 会 生成 一 条 错误 消息 。 如 有 果 搜 索 到 
了 了 用户 名 , 但 是 密码 不 匹配 时 ， 就 会 产生 错误 。 我 们 需要 将 这 些 错误 信息 返回 给 
FAAP 


Passport 使 用 Express 2.x 的 req.flash 方法 将 需要 返回 给 用 户 的 错误 信息 保存 在 队 
列 中 。 在 前 面 章节 中 我 们 并 没有 使 用 过 req.flash， 因 为 它 在 Express 3.x 中 已 经 被 
废弃 。 然 而 ， 为 了 确保 Passport 可 以 正常 地 工作 在 Express 2.x 和 3.x F, Passport 
开发 者 创建 了 一 个 新 模块 connect-flash， 它 实现 了 与 req.flash 相似 的 功能 。 


使 用 npm 安装 connect-flash 模块 : 


npm install connect-flash 


在 应 用 程序 中 使 用 : 


var flash = require('connect-flash'); 


然后 作为 Express 中 间 件 使 用 : 


app.use(flash()); 


此 时 , 在 POSTlogin 路 由 项 中 ,如 采用 户 没有 通过 号 份 验 证 , 他 将 被 重 定 癌 到 登录 
表单 并 给 出 相关 错误 信息 : 


app.post('/login', 
passport.authenticate('local', { failureRedirect: '/login', 
failureFlash: true }), 
function(reg, res) { 
res.redirect('/admin') ; 


E? 


在 身份 验证 过 程 中 产生 的 错误 信息 通过 req.flash 传递 到 了 视图 泻 染 引擎 ， 并 在 呈现 
登录 表单 时 显示 出 来 : 
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app.get('/login', function(req, res) { 
var username = req.user ? req.user.username : ''; 


res.render('login', { title: 'authenticate', username: 


message: req.flash('error') }); 
} ) ; 


视图 引擎 会 将 错误 消息 呈现 在 登陆 表单 之 外 的 其 他 元 素 上 ， 如 下 述 
所 示 : 


extends layout 


block content 
h1 Login 
if message 
p= message 
form(method="POST" 
action="/login" 
enctype="application/x-www-form-urlencoded" ) 
p Username: 
input (type="text" 
name="username" 
id="username" 
Size="25" 
value="#{username }" 
required) 
p Password: 
input (type="password" 
name="password" 
id="password" 
Size="25" 
required) 
input (type="submit" 
name="submit" 
id="submit" 
value="Submit") 
input (type="reset" 
name="reset"™ 
id="reset" 
value="reset") 


username, 


Jade 模板 代码 


为 了 能 更 好 地 说 明 这 些 技术 细 市 ， 我 将 示例 15-3 实现 的 命令 行 认证 应 用 程序 修改 
为 一 个 Express 应 用 程序 ， 代 码 如 示例 15-4 所 示 ， 并 通过 Passport 实现 身份 验证 。 
通过 登录 页 面 的 表单 提交 里 份 认证 信息 是 访问 应 用 程序 管理 页 面 的 唯一 途径 ， 而 访 


问 项 层 索 引 页 则 无 需 身 份 验 证 。 


我 将 示例 15-3 中 有 关 MySQL 的 代码 直接 纳入 到 了 该 程序 的 认证 过 程 中 ( 虽然 通常 


情况 下 这 部 分 功能 会 被 划分 在 一 个 更 加 正式 的 独立 的 应 用 程序 中 )。 


访问 代码 则 通过 用 户 标 识 符 来 反 序列 化 用 户 信息 。 
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态 一 些 MySQL 


示例 15-4 整合 了 密码 hash. MySQL 用 户 表 ， 以 及 Passport 身份 验证 的 Express 


应 用 程序 


// modules 
var express = require('express' ) 
» flash = require(‘connect-flash') 
» Passport = require('passport' ) 
, LocalStrategy = require('passport-local').Strategy 
, http = require('http'); 


var mysql = require('mysql') 
, crypto = require('crypto'); 


// check user authentication 


function ensureAuthenticated(req, res, next) { 
if (req.isAuthenticated()) { return next(); } 
res.redirect(‘/login' ) 


} 


// serialize user to session 
passport.serializeUser(function(user, done) { 
done(null, user.id); 


}); 


// find user in MySQL database 
passport.deserializeUser(function(id, done) { 


var client = mysql.createClient({ 
user : ‘username’, 
password: ‘password ' 


}); 


client.query('USE databasenm'); 


client.query('SELECT username, password FROM user WHERE userid = ?', 
[id], function(err, result, fields) { 

var user = { 
id o Id; 
username : result[0].username, 
password : result[0].password}; 

done(err, user); 

client.end(); 


})3 
}); 


// configure local strategy 

// authenticate user against MySQL user entry 

passport.use(new LocalStrategy( 
function(username, password, done) { 


var client = mysql.createClient({ 


user : ‘username’, 
password: ‘password’ 
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}); 
client.query('USE nodetest2'); 


client.query('SELECT userid, password, salt FROM user WHERE username = ?', 
[username], function(err, result, fields) { 


// database error 
if (err) { 
return done(err); 


// username not found 
} else if (result.length == 0) { 
return done(null, false, {message: ‘Unknown user 


+ username}); 


// check password 
} else { 
var newhash = crypto.createHash('sha512') 
.update(result[0].salt + password) 
.digest('hex'); 


// if passwords match 
if (result[0].password === newhash) { 
var user = {id : result[0].userid, 
username : username, 
password : newhash }; 
return done(null, user); 


// else if passwords don't match 
} else { 
return done(null, false, {message: ‘Invalid password'}); 


} 


client.end(); 


})5 
}))3 


var app = express(); 


app.configure(function(){ 
app.set('views', _ dirname + '/views'); 
app.set('view engine’, '‘jade'); 
app.use(express.favicon()); 
app.use(express. logger('dev')); 
app.use(express.bodyParser()); 
app.use(express.methodOverride()); 
app.use(express.cookieParser('keyboard cat')); 
app.use(express.session()); 
app.use(passport.initialize()); 
app.use(passport.session()); 
app.use(flash()); 
app.use(app.router) ; 
app.use(express.static(_ dirname + '/public')); 


}); 
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app.get('/', function(req, res){ 
res.render('index', { title: ‘authenticate’, user: req.user }); 


}); 


app.get('/admin', ensureAuthenticated, function(req, res){ 
res.render('admin', { title: ‘authenticate’, user: req.user }); 


}); 


app.get('/login', function(req, res){ 
var username = req.user ? req.user.username : ''; 


res.render('login', { title: ‘authenticate’, username: username, 
message: req.flash('error') }); 
}); 


app.post('/login', 
passport.authenticate('local', { failureRedirect: '/login', failureFlash: true }), 
function(req, res) { 
res.redirect('/admin'); 


}); 
http.createServer(app).listen(3000); 


console.log("Express server listening on port 3000"); 


相 比 较 之 前 的 示例 代码 来 说 ， 示 例 15-4 的 代码 比较 长 ， 但 它 的 确 能 比较 好 地 说 明 
在 真实 环境 中 Passport 以 及 之 前 提 及 的 组 件 之 间 是 如 何 工作 的 。 


让 我 们 再 来 仔细 看 看 身份 验证 方法 。 一 旦 应 用 程序 通过 用 户 名 查询 用 户 记 录 后 , 它 
会 调用 回调 也 数 并 传人 一 个 数据 库 错 误 信 息 ( 如 果 发 生 错误 的 话 )。 maa: 
任何 错误 , 但 也 没有 找到 对 应 的 用 户 名 时 , MAET 2 ad G1 a] eR CO username 
设置 为 false 以 表示 该 用 户 不 存在 ， 并 给 出 相应 的 描述 消息 。 如 果 该 用 户 存在 ， 但 
密码 不 匹配 时 ， 处 理 方法 类 似 : 为 username 返回 false 值 ， 并 生成 一 条 消息 。 


当 没有 数据 库 错 误 ， 用 户 在 user 表 中 人 存在， 并 且 密 码 匹 配 时 ， 用 户 对 象 才能 被 创 
建 并 传递 给 回调 少数 : 


// database error 
if (err) { 
return done(err); 
// username not found 
} else if (result.length == 0) { 
return done(null, false, {message: ‘Unknown user ' + username}); 


// check password 
} else { 
var newhash = crypto.createHash('sha512' ) 
.update(result[0].salt + password) 
.digest('hex'); 


安全 及 防护 329 


// if passwords match 
if (result[0].password === newhash) { 
var user = {id : result[0O].userid, 
username : username, 
password : newhash }; 
return done(null, user); 


// else if passwords don't match 
} else { 
return done(null, false, {message: ‘Invalid password’ }); 


} 


该 用 户 对 象 随后 被 序列 化 到 session 中 ， 同 时 用 户 被 授权 访问 管理 页 面 。 只 要 当前 
会 话 不 结束 ， 用 户 便 可 以 继续 访问 管理 页 面 而 无 需 再 次 输入 验证 信息 。 


15.2.3 Twitter Passport Strategy (OAuth) 


我 们 可 以 使 用 OAuth 来 完成 身份 验证 ， 而 不 需要 在 本 地 存储 用 户 名 和 密码 ， 也 不 
需要 再 自己 实现 号 份 验证 逻辑 。 同 时 ， 这 也 是 一 种 将 我 们 的 站 点 与 其 他 第 三 方 站 点 
(如 Facebook 、Google+ 或 Twitter 等 ) 进行 紧密 集成 的 方式 。 


Passport 可 以 通过 passport-twitter 模块 来 使 用 Twitter 提供 的 身份 验证 功能 。 首先 使 
用 npm 安装 该 模块 : 


npm install passport-twitter 


为 了 使 用 Twitter 的 OAuth HET ADH BE, 你 需要 拥有 Twitter 开发 人 员 账 户 ， 
并 能 得 到 consumerkey 和 consumersecret。 它 们 被 用 于 在 应 用 程序 中 生成 OAuth 
请 求 。 


一 日 你 得 到 了 consumerkey 和 secret， 就 可 以 在 创建 Twitterstrategy 实例 时 , 将 它们 
与 callbackURL 一 起 传递 给 构造 本 数 : 


passport.use(new TwitterStrategy( 
{ consumerKey: TWITTER CONSUMER KEY, 
consumerSecret: TWITTER CONSUMER SECRET, 
callbackURL: "http://examples.burningbird.net:3000/auth/twitter/callback"}, 
function(token, tokenSecret,profile,done) { 
findUser(profile.id, function(err,user) { 
console. log(user) ; 
if (err) return done(err); 
if (user) return done(null, user); 
createUser(profile, token, tokenSecret, function(err, user) { 
return done(err,user) ; 


BE 
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尽管 Twitter 可 以 提供 身份 认证 功能 ， 但 你 仍然 很 有 可 能 需要 一 种 方法 来 存储 用 户 
信息 。 在 创建 Twitter strategy 实例 的 代码 块 中 ,你 会 注意 到 其 回调 函数 可 接受 的 参 
数 包括 : token、tokenSecret、profile， 以 及 男 一 个 回调 函数 。 在 通过 Twitter 的 身份 
验证 后 ， 其 返回 的 响应 信息 中 会 包含 token 和 tokenSecret。token 和 tokenSecret 用 
于 与 Twitter 上 的 个 人 账户 进行 交互 , 例如 发 布 最 新 的 tweets. tweet 到 好 友 的 账户 ， 
或 查看 好 友 的 关注 者 ( follower ) 信息 等 。 总 之 用 户 在 Twitter 页 面 上 能 够 看 到 的 所 
有 信息 都 能 够 通过 Twitter 的 API 取得 。 


HEX, 我们 真正 感 兴趣 的 是 profile 对 象 。 它 包含 了 有 关 个 人 账户 的 许多 信息 ， 包 
fh: Twitter JE., ZZ. WR, ME, MRE., follower 数量 、followed 数量 、 
tweet 数量 等 。 这 些 正 是 我 们 需要 提取 并 在 本 地 数据 库存 储 的 用 户 信 息 。 我 们 没有 
保存 密码 ， 而且 Oauth 也 没有 公开 个 人 的 身份 验证 信息 。 相 反 , 我 们 只 是 存储 一 些 
我 们 会 在 web 程序 中 使 用 到 的 有 助 于 区 分 用 户 的 个 性 化 信息 。 


当 对 用 户 进行 身份 验证 时 ， 应 用 程序 会 根据 他 的 Twitter 标识 符 在 本 地 数据 库 中 查 
找 。 如 果 对 应 的 标识 符 存 在 , 则 返回 本 地 存储 的 用 户 信 息 。 如 果 没 有 找到 对 应 的 用 
户 标 识 符 ， 则 会 在 数据 库 中 创建 并 记录 一 条 新 用 户 信息 。 在 程序 中 我 们 使 用 findUser 
和 createUser 两 个 限 数 用 来 实现 上 述 处 理 过程 。findUser ROTA Passport 从 session 
反 序 列 化 用 户 信息 提供 支持 : 


passport.deserializeUser(function(id, done) { 
findUser(id, function(err, user) { 
done (err,uSer); 
} ) 7 
}); 


我 们 不 再 需要 登录 页 面 ， 因 为 Twitter 可 以 提供 登录 表单 。 因 此 在 应 用 程序 中 只 包 
含 了 一 个 可 以 通过 Twitter 完成 认证 的 链接 : 


extends layout 
block content 
hi= title 
a(href='/auth/twitter') Login with Twitter 


如 果 用 户 没 有 登录 到 Twitter， 那 么 程序 将 会 为 他 呈现 一 个 登录 页 面 ， 如 图 15-3 
所 示 。 


一 旦 用 户 成 功 登 录 ， 网 页 将 被 重新 重 定 到 应 用 程序 ， 然 后 显示 用 户 管理 页 面 。 目 前 , 管 
理 页 面 只 是 简单 地 输出 一 些 从 Twitter 上 取得 的 用 户 信息 ， 包 括 用 户 的 网 络 昵称 和 头像 : 
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15-3 Node 应 用 程序 中 的 Twitter 登录 和 授权 页 面 
extends layout 


block content 
hl #{title} Administration 
p Welcome to #{user.name} 


p 
img (src='#{user.img}',alt='avatar') 


而 这 些 数据 是 在 完成 第 一 次 认证 时 保存 的 。 如 果 打 开 你 的 Twitter 账户 设置 页 面 ， 
然后 点 击 应 用 程序 ， 你 会 在 列表 中 看 到 我 们 的 应 用 程序 ， 如 图 15-4 所 示 。 














: Applications 









Learning Node Test Application 


Revoke access 
x fast application for an exanipie in the sac 








15-4 包含 了 Node 示例 程序 的 Twitter 应 用 设置 页 面 
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MySQL 数据 库 中 。 当然 , 你 也 可 以 将 数据 存储 在 MongoDB 中 , 甚至 是 Redis 也 行 。 
我 们 没有 使 用 Crypto 模块 耻 ， 因 为 我 们 不 再 需要 存储 密码 了 ， 这 也 是 通过 第 三 方 
服务 进行 身份 验证 的 一 个 明显 优势 。 


示例 15-5 通过 Twitter 实现 用 户 验证 的 完整 示例 程序 


var express = require('express’) 

flash = require(‘connect-flash' ) 

passport = require('passport' ) 

TwitterStrategy = require('passport-twitter' ).Strategy 
http = require('http'); 


示例 15-5 是 一 个 完整 示例 代码 ， 实 现 了 了 Twitter 用 户 认 证 并 将 用 户 信 息 保 存在 


= Ea kd v 


var mysql = require('mysql'); 


var TWITTER_CONSUMER_KEY = "yourkey"; 
var TWITTER CONSUMER SECRET = "yoursecret"; 


var client = mysql.createClient({ 
user : ‘username’, 
password : ‘password’ 


})5 
client.query('USE nodetest2'); 


function findUser(id, callback) { 
var uSer; 


client.query('SELECT * FROM twitteruser WHERE id = ?', 
[id], function(err, result, fields) { 

if (err) return callback(err) ; 
user = result[0]; 
console. log(user) ; 
return callback(null, user) ; 

})5 

}; 


function createUser(profile, token, tokenSecret, callback) { 


var qryString = ‘INSERT INTO twitteruser ' + 
'(id, name, screenname, location, description,’ + 
‘url, img, token, tokensecret)' + 
< 
client.query(qryString, [ 
profile.id, 
profile.displayName, 
profile.username, 
profile. json. location, 
profile. json.description, 
profile. json.url, 
profile. json.profile image url, 
token, 
tokenSecret], function(err, result) { 
if (err) return callback(err); 
var user = { 
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id : profile.id， 
name : profile.displayName, 
screenname : profile.screen_name, 
location : profile. json. location, 
description: profile. json.description, 
url : profile. json.url, 
img : profile. json.profile_image url, 
token : token, 
tokensecret : tokenSecret}; 
console. log(user) ; 
return callback(null, user); 
}); 
}; 


function ensureAuthenticated(req, res, next) { 
if (req.isAuthenticated()) { return next(); } 
res.redirect('/auth/twitter' ) 

} 


passport.serializeUser(function(user, done) { 
done(null, user.id); 


73 


passport.deserializeUser(function(id, done) { 
findUser (id, function(err, user) { 
done(err, user); 
}); 
}); 


passport.use(new TwitterStrategy( 
{ consumerKey: TWITTER_CONSUMER_KEY, 
consumerSecret: TWITTER CONSUMER SECRET, 
callbackURL: "http://examples.burningbird.net:3000/auth/twitter/callback"}, 
function(token, tokenSecret,profile,done) { 
findUser(profile.id, function(err,user) { 
console. log(user) ; 
if (err) return done(err); 
if (user) return done(null, user); 
createUser(profile, token, tokenSecret, function(err, user) { 
return done(err,user) ; 
}); 
}) 
}) 
); 


var app = express(); 


app.configure(function(){ 
app.set('views', _ dirname + '/views'); 
app.set('view engine’, ‘jade’); 
app.use(express. favicon()); 
app.use(express. logger('dev')); 
app.use(express.bodyParser()); 
app.use(express.methodOverride()); 
app.use(express.cookieParser('keyboard cat')); 
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app.use(express.session()); 
app.use(passport.initialize()); 
app.use(passport.session()); 

app.use(flash()); 

app.use(app.router) ; 
app.use(express.static(_ dirname + '/public')); 


})5 


app.get('/', function(req, res){ 
res.render('index', { title: ‘authenticate’, user: req.user }); 


})3 


app.get('/admin', ensureAuthenticated, function(req, res){ 
res.render('admin', { title: ‘authenticate’, user: req.user }); 


}); 


app.get('/auth', function(req,res) { 
res.render(‘auth', { title: ‘authenticate’ }); 


D> 


app.get('/auth/twitter', 
passport.authenticate('twitter'), 
function(req, res){ 


H 


app.get('/auth/twitter/callback', 
passport.authenticate('twitter', { failureRedirect: '/login' }), 
function(req, res) { 
res.redirect('/admin'); 


}); 
http.createServer(app).listen(3000); 


console.log("Express server listening on port 3000"); 


在 Node 中 ， 其 他 OAuth 服务 的 使 用 步骤 与 Twitter Passport strategy 类 似 。 你 甚 
至 能 直接 使 用 上 述 Twtter 认证 代码 来 通过 Facebook 的 OAuth 服务 验证 用 户 。 唯 
一 的 区 别 是 ， 你 需要 提供 Facebook key 和 secret， 而 非 Twitter 的 。 考 虑 到 认证 
处 理 代码 的 相似 性 ， 今 天 的 许多 应 用 程序 都 支持 使 用 多 种 OAuth 服务 完成 用 户 
Et ik © 


Passport Xf As FIRA R [ET EY OC A A a Ee, BE EA AN Te RS ， 
处 理 profile 对 象 的 代码 改动 也 不 会 过 大 。 然 而 ， 你 还 是 需要 对 返回 的 profile 信息 
进行 分 析 ， 以 确定 哪些 是 需要 的 ， 哪 些 不 需要 ， 以 及 哪些 需要 存储 。 


如 果 用 户 撤销 了 OAuth 服务 对 应 用 程序 的 访问 授权 ， 并 且 还 决定 使 用 另 一 个 服务 
来 通过 身份 验证 。 在 这 种 情况 下 ,应 用 程序 将 会 创建 一 条 新 的 用 户 信息 并 存储 起 来 ， 
然后 继续 正常 运行 。 但 数据 库 中 仍然 保存 了 之 前 用 户 认 证 时 的 信息 , 而 且 并 没有 因 
为 用 户 更 换 认证 服务 而 得 到 更 新 , 这 是 唯一 的 负面 影响 。 我 将 把 这 个 问题 留 给 你 作 
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为 练习 。 现 在 是 时 候 来 看 看 影响 应 用 程序 安全 性 的 为 一 方面 : 表单 数据 。 


15.3 ”保护 应 用 程序 ， 防 止 攻击 


作为 一 名 JavaScript 开发 人 员 , 你 可 能 明白 直接 将 用 户 输入 传递 给 eval 语句 执行 的 
危害 。 作 为 一 个 Web 开发 人 员 ， 你 也 明白 将 用 户 通过 表单 提交 的 文本 信息 未 经 处 
理 直 接 附加 在 SQL 语句 where 子 句 后 的 危害 。 


其 实 ， 所 有 Node 应 用 程序 都 具有 与 客户 端 JavaScript 应 用 程序 一 样 的 弱点 。 此 外 ， 
作为 使 用 数据 库 系 统 ( 特别 是 关系 型 数据 库 系 统 ) SARS ABE, Node 应 用 程 
序 也 同样 存在 着 上 述 使 用 SQL 语句 的 弱点 。 

正如 上 节 所 述 , 为 了 确保 你 的 应 用 程序 是 安全 的 , 你 需要 提供 良好 的 授权 和 认证 系 
统 。 同 时 你 还 需要 保护 你 的 应 用 程序 人 免 受 注入 式 攻击 , 或 其 他 企图 越过 授权 系统 以 
获取 重要 保密 数据 的 行为 。 

此 前 我 们 通过 用 户 提 交 的 登录 表单 接收 文本 信息 并 将 其 直接 使 用 在 SQL 查询 语句 
中 。 这 不 是 明智 的 做 法 ， 因 为 任何 人 都 可 以 在 文本 中 附加 内 容 而 对 SQL 数据 库 造 
成 伤害 。 例 如 ， 如 果 文 本 是 为 WHERE 子 句 提供 数据 ， 并 被 直接 附加 在 WHERE 
语句 后 : 


Var whereString = "WHERE name = " + name; \ 


如 果 name 字符 串 包 含 以 下 内 容 : 


'johnsmith; drop table users' 


你 就 会 磁 到 问题 。 当 处 理 来 自用 户 输入 的 文本 或 JSON 数据 时 , 都 有 可 能 发 生 类 似 
问题 : 用 户 的 输入 数据 可 能 对 系统 造成 伤害 。 


不 过 我 们 可 以 在 使 用 输入 信息 前 对 其 净化 ， 以 防止 这 两 种 类 型 的 漏洞 。 我 们 还 需要 
利用 其 他 一 些 工具 和 技术 ,来 尽 可 能 确保 我 们 的 应 用 程序 是 安全 的 。 


15.3.1 不 要 使 用 eval 

不 管 是 否 是 Node 环境 中 使 用 JavaScript， 一 个 简单 的 规则 可 以 让 你 的 应 用 程序 更 安 
全 : 不 要 使 用 eval. eval 函数 是 限制 最 少 且 最 宽松 的 JavaScript 组 件 ， 我 们 应 该 说 
慎 使 用 它 。 


在 大 多 数 情况 下 ， 我 们 并 不 需要 使 用 eval。 例 如 ， 当 需要 将 一 个 ISON 字符 串 转换 
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成 一 个 对 象 时 ， 我 们 可 能 会 想到 使 用 它 。 然 而 ， 还 有 另 一 种 简单 的 可 以 防止 
JavaScript 注入 攻击 ， 并 能 将 字符 串 转换 成 对 象 的 方法 是 使 用 JSON.parse 来 处 理 
JSON, MHE eval. eval 语句 不 会 对 文本 中 包含 的 内 容 进行 辨识 ， 而 JSON.parse 则 
会 验证 文本 内 容 并 判断 是 否 为 有 效 的 JSON 格式 : 


var someObj = JSON.parse(jsonString) ; 


考虑 到 Node 使 用 的 是 V8 引擎 ， 我 们 可 以 直接 访问 ISON WA; 当然 ， 我 们 更 不 
必 担 心 跨 浏览 器 问题 。 


15.3.2 尽量 使 用 复 选 框 、 单 选 按钮 和 下 拉 式 选项 

另 一 条 开发 Web 应 用 程序 应 该 遵循 的 简单 规则 是 : 尽量 减少 用 户 在 Web 表单 中 输 
入 自由 文本 的 机 会 。 尽量 使 用 下 拉 选 项 、 复 选 框 或 单 选 按钮 , 而 非 开 放 的 文本 字段 。 
这 样 不 仅 能 确保 得 到 安全 的 数据 ， 还 能 保证 数据 的 一 致 性 和 可 靠 性 。 


几 年 前 ,我 曾 清理 过 一 个 数据 库 表 ， 其 中 的 数据 大 多 来 目 客户 ( 航空 工程 师 ) 使 
用 的 一 个 表单 。 表 单 中 的 所 有 输入 项 都 是 通过 开放 文本 收集 的 ， 其 中 有 一 个 数据 
字段 需要 用 户 输入 零件 标识 信息 ， 但 并 不 对 输入 内 容 做 任何 验证 ， 这 正 是 豆 梦 的 


工程 师 决定 将 该 字段 当做 “备注 或 任何 其 他 内 容 ” 来 使 用 ， 因 为 表单 中 恰好 没有 设 
置 这 种 字段 。 最 终 我 发 现 这 个 字段 中 保存 的 数据 范围 非常 广 ， 从 零件 标识 到 一 个 工 
程 师 设置 的 提醒 信息 〈 与 供应 商 的 午餐 预订 )。 这 些 信息 读 起 来 非常 有 趣 ， 但 对 这 
个 公司 并 没有 什 帮助 。 这 种 数据 也 是 非常 难以 清理 的 ， 因 为 来 自 不 同 供应 商 的 部 件 
编号 格式 并 不 相似 ， 以 至 于 我 们 也 很 难 用 正则 表达 式 来 清理 数据 。 


这 是 一 个 非 故 意 伤害 的 例子 。 而 在 上 一 小 节 中 , 我 们 曾经 将 一 条 删除 数据 库 的 SQL 
语句 附加 在 了 wsehame 后 面 ， 这 是 一 个 故意 伤害 的 例子 。 


如 果 你 必须 使 用 一 个 自由 文本 来 取得 用 户 输入 ,例如 在 用 户 登 录 系统 时 需要 输 
入 用 户 名 ， 那 么 你 就 需要 先 对 输入 信息 进行 预 处 理 ， 然 后 再 使 用 它 做 更 新 或 查 
询 操 作 。 


15.3.3 使 用 node-validator 


如 果 你 的 应 用 程序 必须 通过 文本 输入 方式 取得 数据 ， 那 么 在 使 用 数据 前 ， 务 必要 对 
该 数据 进行 有 效 性 验证 和 预 处 理 。node-mysql 模块 提供 了 client.escape 方法 ， 它 能 
对 传人 的 文本 进行 编码 以 防止 潜在 的 SQL 注入 攻击 。 你 还 可 以 禁用 那些 具有 潜在 
破坏 性 的 功能 。 在 第 10 章 有 关 MongoDB 的 讨论 中 ， 我 曾 提 到 过 如 何 标记 一 个 应 


安全 及 防护 337 


该 被 序列 化 存储 的 JavaScript PRAY. 


你 还 可 以 使 用 验证 工具 来 确保 传人 的 数据 是 安全 和 一 致 的 。node-validator 就 是 一 个 
比较 优秀 的 验证 工具 。 


使 用 npm 安装 node-validator: 
npm install node-validator 


该 模块 对 外 暴露 两 个 对 象 : check 和 sanitize: 


var check = require('validator').check, 
sanitize = require('validator').sanitize; 


你 可 以 通过 上 述 两 个 对 象 来 检查 输入 数据 的 格式 是 否 符合 使 用 要 求 ， 如 检查 输入 文 
本 以 确保 它 是 一 个 电子 邮件 格式 : 


try { 
check (email) .isEmail(); 
} catch (err) { 
console.log(err.message); // Invalid email 


} 


当 数 据 无 法 匹配 期 望 格式 时 ，node-validator 会 抛 出 一 个 错误 。 如 果 想 让 错误 信 
息 更 加 可 读 ， 你 可 以 自 定 义 错误 信息 并 将 其 作为 check 方法 的 第 二 个 可 选 参数 
传人 : 


try { 

check (email, "Please enter a proper email") .isEmail(); 
}catch (err) { 

console.log(err.message); // Please enter a proper email 


而 sanitize 过 滤 需 可 以 用 来 检测 数据 并 防止 特定 类 型 的 攻击 : 

var newstr = sanitize(str).xss(); // prevent XSS attack 
示例 15-6 使 用 了 check 和 sanitize 方法 处 理 三 种 不 同 的 字符 串 。 
示例 15-6 使 用 node-validator 


var check = require('validator').check, 
sanitize = require('validator').sanitize; 


var email = 'shelleyp@burningbird.net' ; 
var email2 = 'this is a test’; 


var str = ‘<SCRIPT SRC=http://ha.ckers.org/xss.js></SCRIPT>’ ; 
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try { 
check(email).isEmail(); 
check(email2).isEmail(); 
} catch (err) { 
console. log(err.message) ; 


var newstr = sanitize(str).xss(); 
console. log(newstr) ; 


运行 该 应 用 程序 的 结果 是 : 


Invalid email 
[removed | [removed] 


还 有 Express 中 间 件 支 将 node 验证 硕 : express-validator。 当 我 们 将 其 包含 到 Express 
应 用 程序 中 : 


var expressValidator = require('express-validator' ); 


app.use(expressValidator) ; 


可 以 直接 在 请 求 对 象 上 访问 check, sanitize 以 及 其 他 提供 的 方法 。 
app.get('/somepage', function (req, rest) { 


req.check('zip', 'Please enter zip code').isInt(6); 
req.sanitize('newdata' ).xss(); 


re 


15.4 在 沙 相 中 执行 代码 


Node 中 的 vm 模块 可 以 提供 一 个 沙 箱 并 安全 地 执行 JavaScript 代码 。 它 能 虚拟 一 个 
全 新 的 V8 环境 ， 并 通过 参数 传人 JavaScript 代码 然后 运行 。 


4 提示 
沙 箱 通常 意味 着 隔离 代码 ， 使 其 不 能 做 执行 任何 有 定 操作 . 


me 
s, 


使 用 vm 的 方法 很 多 。 首 先 我 们 可 以 使 用 vm.createScript 方法 并 传人 一 段 脚本 作为 
方法 参数 。vm 模块 会 编译 它 并 返回 一 个 脚本 对 象 : 


var vm = require('vm'); 
var script obj = vm.createScript(js text); 


然后 ， 你 可 以 在 一 个 单独 的 上 下 文中 运行 脚本 并 将 脚本 执行 所 需要 的 任何 数据 作为 
可 选 对 象 传 入 : 
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script obj.runInNewContext (sandbox) ; 
示例 15-7 SBE, (EER Ee) a, CEH vm 编 详 了 一 段 JavaScript 
语句 ， 还 使 用 了 两 个 沙 箱 对 象 属 性 ， 并 且 创 建 了 第 三 个 。 
示例 15-7 使 用 vm 模块 在 沙 箱 中 执行 脚本 

var vm = require('vm'); 

var util = require('util'); 

var obj = { name: ‘Shelley’, domain: ‘burningbird.net'}; 


// compile script 
var script obj = vm.createScript("var str = 'My name is ' + name + at ' + domain”, 
"test.vm'); 


// run in new context 
script_obj.runInNewContext (obj); 


// inspect sandbox object 
console. log(util.inspect (obj) ); 


运行 应 用 程序 后 返回 如 下 输出 : 


{ name: 'Shelley', 
domain: ‘'burningbird.net', 
str: 'My name is Shelley at burningbird.net' } 


obj 对 象 是 应 用 程序 和 沙 箱 脚 本 之 间 的 连接 点 。 脚 本 无 法 通过 其 他 方式 访问 到 父 上 
下 文 环境 。 如 果 你 尝试 在 脚本 中 使 用 全 局 对 象 ， 例 如 console， 那 么 程序 会 报错 。 


为 了 能 更 好 地 进行 说 明 ， 示 例 15-8 修改 了 示例 15-7 的 代码 ， 从 文件 中 加 载 脚本 并 


运行 。 被 加 载 的 脚本 文件 内 容 与 前 面 例子 中 使 用 的 脚本 内 容 基 本 一 至 ,只 是 增加 了 
一 名 对 console.log 的 调用 : 


vars tr = 'My name is ' + name + ' from ' + domain; 
console.log({str) : 


vm.createScript 不 文 持 直接 从 文件 中 加 载 脚本 。 其 第 二 个 〈 可 选 ) 参数 并 不 是 文件 
名 ， 而 是 一 个 名 字 标 签 ， 用 于 在 调试 时 输出 堆栈 调用 信息 。 因 此 ,我 们 将 使 用 文件 
系统 模块 提供 的 readFile 方法 来 读 取 脚本 文件 的 内 容 。 


示例 15-8 从 文件 加 载 脚 本 ,并 使 用 vm 模块 在 沙 箱 中 执行 


var vm = require('vm'); 
var util = require('util'); 
var fs = require('fs'); 


fs.readFile('suspicious.js', 'utf8', function(err, data) { 
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if (err) return console.log(err); 


try { 


console. log(data) ; 
var obj = { name: 'Shelley', domain: ‘burningbird.net'}; 


// compile script 
var script obj = vm.createScript(data, 'test.vm'); 


// run in new context 
script _obj.runInNewContext (obj) ; 


// inspect sandbox object 

console. log(util.inspect(obj)); 
} catch(e) { 

console. log(e); 


}); 
运行 应 用 程序 返回 以 下 内 容 : 


[SyntaxError: Unexpected token :|] 


程序 发 生 了 错误 ， 不 过 这 也 正 是 我 们 期 望 的 ， 因 为 在 虚拟 机 中 并 不 存在 console 对 
象 。 注 意 它 是 一 个 V8 虚拟 机 ， 而 不 是 一 个 Node 虚拟 机 。 我 们 已 经 看 到 过 Node 
应 用 程序 的 子 进程 可 以 实现 任何 处 理 操 作 。 我 们 当然 不 希望 沙 箱 代 码 也 拥有 这 种 
权限 。 


由 于 我 们 可 以 在 一 个 V8 上 下 文中 运行 脚本 ， 这 意味 着 它 可 以 访问 global MA. AN 
例 15-9 重新 修改 了 示例 15-8 的 程序 代码 ， 除 了 使 用 runInContext 方法 外 ， 还 为 其 
传递 了 一 个 上 下 文 对 象 。 而 这 个 上 下 文 对 象 则 通过 一 个 包含 了 执行 脚本 所 需 参 数 的 
obj 对 象 来 初始 化 。 在 脚本 执行 后 输出 obj 对 象 的 内 容 ， 你 会 发 现 其 中 并 没有 新 定 
义 的 str 属性 。 而 检查 上 下 文 对 象 的 内 容 时 ， 却 能 发 现 它 。 


示例 15-9 在 vm 中 使 用 context 对 象 运行 代码 
var vm = require('vm'); 
var util = require('util'); 


var fs = require('fs'); 


fs.readFile('suspicious.js', ‘utf8', function(err, data) { 
if (err) return console.log(err); 


try { 
var obj = { name: ‘Shelley’, domain: 'burningbird.net' }; 


// compile script 
var script obj = vm.createScript(data, ‘test.vm'); 
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// create context 
var ctx = vm.createContext(obj) ) ; 


// run in new context 
script_obj.runInContext(ctx) ; 


// inspect object 
console. log(util.inspect(obj)); 


// inspect context 
console. log(util.inspect(ctx)); 


} catch(e) { 
console. log(e); 


}); 


示例 程序 使 用 了 预 编 译 脚本 块 ， 如 果 你 要 多 次 运行 脚本 ， 这 会 很 方便 。 如 果 只 需要 
运行 一 次 脚本 ， 你 可 以 直接 在 vm 对 象 上 调用 runInContext 和 runInThisContext 方 
法 来 执行 脚本 并 关闭 虚拟 机 。 不 同 的 是 ， 你 必须 将 脚本 作为 第 一 个 参数 传递 给 这 两 


TIA: 
var obj = { name: 'Shelley', domain: 'burningbird.net' }; 
// create context 
var ctx = vm.createContext (obj); 


// run in new context 
vm.runīIīInContext (data, ctx, 'test.vm'); 


// inspect context 
console.log (util.inspect (ctx) ); 


同样 的 ， 我 们 通过 createContext 创建 上 上下文， 然后 使 用 数据 对 其 初始 化 ， 沙 箱 代码 
就 能 够 访问 上 下 文中 的 global 对 象 。 而 且 在 沙 箱 代码 执行 完毕 后 ， 所 有 的 处 理 结果 
都 能 够 从 上 下 文 对 象 中 获得 。 
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第 15 章 


第 16 章 


扩展 和 部 署 Node 应 用 


现在 ， 你 希望 把 你 的 Node 应 用 从 开发 和 测试 环境 转移 到 产品 环境 上 去 。 这 个 过 程 
可 能 很 简单 也 可 能 很 复杂 ， 这 一 切取 决 于 你 的 程序 功能 及 其 提供 的 服务 (或 者 需要 
的 组 件 )。 


下 面 我 会 简要 介绍 Node 应 用 在 产品 环境 上 部 署 的 过 程 和 可 能 遇见 的 问题 。 一 些 要 
求 可 能 只 需要 很 少 的 精力 就 可 以 完成 ， 比 如 需要 安装 Forever 来 确保 Node 程序 可 
以 一 直 运 行 。 其 他 一 些 ， 比 如 把 程序 部 署 到 云 节点 上 ， 可 能 需要 提前 规划 并 且 会 花 
费 很 多 时 间 。 


16.1 把 你 的 节点 部 署 到 服务 器 上 


将 程序 从 开发 环境 转移 到 产品 环境 并 不 是 特别 复杂 ， 但 是 需要 做 一 些 部 署 的 准备 ， 
以 确保 程序 部 署 之 后 发 挥 最 佳 性 能 以 及 将 潜在 风险 降 到 最 低 。 


部 署 Node 应 用 的 一 些 前 提 条 件 : 

。 ”程序 必须 通过 用 户 和 开发 人 员 的 双重 测试 ; 

。 ”需要 安全 地 部 署 程序 ， 确 保 协调 好 修改 和 修复 ; 

。 ”应 用 程序 必须 安全 ; 

。 ”必须 确保 如 果 有 意外 发 生 程 序 会 自动 重启 ; 

。 需要 将 Node 应 用 与 其 他 服务 顺 集 成 ， 比 如 Apache; 


343 


。 需要 监控 程序 性 能 ， 并 且 在 性 能 下 降 时 可 以 调整 程序 参数 ; 
。 ”必须 充分 利用 服务 融资 源 ; 


第 14 章 讲 到 了 单元 测试 、 验 收 测试 和 性 能 测试 , 第 15 章 中 讲 到 了 安全 问题 。 在 这 
E, 我 们 学 习 一 下 其 他 部 署 Node 程序 到 你 自己 的 产品 环境 服务 右 中 的 必要 操作 。 


16.1.1 4955 package.json 文件 


每 个 Node 模块 都 有 一 个 package.json 文件 ， 包 含 该 模块 的 基本 信息 ， 以 及 模块 可 
能 需要 的 依赖 。 在 第 4 章 中 讨论 模块 时 我 曾 提 到 过 package.json 文件 。 现 在 ， 我 们 
来 进一步 研究 该 文件 ， 特 别 是 当 你 需要 使 用 它 来 进行 部 署 时 。 


从 文件 名 可 以 看 出 package.json 肯定 是 某 种 JSON。 可 以 运行 npminit X ER 
package.json 过 程 。 我 在 第 4 章 中 运行 npminit 命令 时 并 没有 提供 任何 依赖 ， 但 是 绝 
大 多 数 的 Node 程序 都 有 自己 的 依赖 。 


我 们 在 本 书 之 前 几 章 中 创建 的 widget 程序 尽管 很 小 ， 但 是 作为 应 用 程序 的 一 个 范 
例 ， 它 是 我 们 考虑 部 署 时 一 个 很 好 的 例子 。 那 么 ， 它 的 package.json 文件 是 怎样 
的 呢 ? 

提示 

我 并 没有 涉及 package.json 文件 中 的 全 部 数据 ， 只 涉及 了 那些 对 Node 
程序 来 说 有 意义 的 数据 。 





开始 前 , 我 们 需要 提供 应 用 程序 的 基本 信息 , 包括 程序 名 称 、 版本、 主要 开发 人 员 : 


{ 
“name”: “WidgetFactory”, 
“preferGlobal”: “false”, 
“version”: “1.0.07; 
“author”: “Shelley Powers shelley.just@gmail.com (http: //burningbird.net)” 
“description”: “World’s best Wdiget Factory”, 


注意 到 name 属性 的 值 中 不 能 有 空格 。 
Author 属性 的 值 也 可 以 划分 为 不 同 部 分 ， 如 下 : 


“author”: { “name”: “Shelley Powers”, 
“email”: shelley.just@gmail.com, 
“url”: http: s7burningbird,. net}, 
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不 过 author 属性 使 用 单一 的 值 比 较 简单 。 


如 果 程 序 还 有 其 他 的 开发 人 员 ， 你 可 以 将 他 们 列 为 数组 ， 作 为 contributors 关键 词 
的 值 。 每 个 人 的 信息 与 author 相同 。 
如 果 Widget Factory 程序 有 二 进 制 码 程序 ， 可 以 放 在 bin 属性 中 。 一 个 使 用 bin 目 
录 的 例子 是 Noadload， 在 package.json 文件 中 表现 为 : 
“bin” z { 
“nodeload.js”: “./nodeload.js”, 


“Hise S AET a: es Fe a 


by 


这 段 配置 告诉 我 们 的 内 容 是 当 模 块 全 局 安装 时 ， 可 以 输入 nl js 来 运行 该 Node 
程序 。 


Widget 应 用 并 没有 命令 行 工 具 ， 也 没有 任何 脚本 。Scripts 关键 词 表 示 在 包 生 命 周 
期 内 运行 的 所 有 脚本 。 在 生命 周期 内 可 能 发 生 的 事件 包括 preinstall, install, publish. 
start. test 和 updtae 等 ， 每 个 都 可 以 有 自己 的 脚本 。 


如 果 在 Node 程序 或 者 模块 的 目录 中 输入 以 下 npm 命令 : 
npm test 
test.js 脚本 会 执行 : 
“scripts” : { 


“test”: “node ./test.js” 


by 


在 widget 程序 的 scripts 中 除了 安装 必须 的 脚本 〈 比如 设置 应 用 程序 环境 的 脚本 ) 
之 外 ， 还 应 该 包含 单元 测试 的 脚本 。 尽 管 Widget Factory 暂时 还 没有 启动 脚本 ， 但 
你 的 程序 应 该 有 ， 特 别 是 如 果 程 序 准备 部 署 在 云 服务 上 的 时 候 (下 一 节 讨 论 这 
个 问题 )。 


如 果 你 没有 任何 scripts 的 值 ，npm 提供 默认 值 。 对 启动 脚本 来 说 ， 如 果 程 序 包 的 
根 目录 下 有 server.js 文件 ，Node 程序 默认 的 启动 脚本 为 : 


node server.js 


repository 属性 提供 了 程序 所 使 用 的 源 代 码 版 本 管理 工具 的 信息 ， 其 中 的 url 属性 表 
示 源 代码 的 链接 ( 如果 源 代码 公开 的 话 ): 


“reposotory”: { 
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“type”: baa fe wae 
“url”: https://github.com/yourname/yourapp.git 
by 


repository 属性 只 有 在 公布 程序 源 代 码 (尽管 你 还 是 可 以 限制 特定 用 户 组 访问 ) 时 
才 比 较 重 要 。 提 供 repository 属性 的 一 个 优点 是 用 户 可 以 通过 npm docs 访问 你 的 
文档 : 


npm docs packagename 


在 我 的 Ubuntu ASF, AFCA AAC SLA Lynx: 


npm config set browser lynx 


然后 我 打开 第 15 章 中 讲 到 的 认证 模块 Passport 的 文档 : 


npm docs passport 
repository 属性 的 设置 有 助 于 npm 找到 文档 。 


Package.json 文件 的 一 个 更 重要 的 设计 是 指出 什么 版 本 的 程序 可 以 运行 ， 可 以 用 
engine 属性 描述 这 一 信息 。 在 Widget Factory 的 例子 中 ， 发 布 的 0.6.x 和 0.8.2 通过 
测试 为 稳定 版 本 ， 意 味 着 之 后 的 0.8 版 本 也 可 以 工作 。 抱 着 好 的 希望 ， 设 置 engine 
选项 为 : 


“engines”: { 
“node”: “>= 0.6.0 < 0.9.0” 
by 


widget 程序 在 开发 和 产品 环境 中 都 有 一 些 依赖 。 这 些 都 会 单独 列 出 来 ， 前 者 的 依赖 
在 devDependencies 中 ， 后 者 在 dependencies 中 。 每 一 个 模块 依赖 都 作为 一 个 属性 ， 
其 版 本 作为 对 象 的 值 : 


“dependencies” : { 
“express” : “3.07, 
“Jade g “rej 
“stylus 3 
“Pears” e ~ TH 4 
“mongoose” : “*” 
by 
“devDependencies” : { 
“nodeunit” : “*” 


} 


如 果 有 关于 操作 系统 或 者 CPU 的 依赖 ， 也 可 以 在 这 里 列 出 来 : 
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“cpu”: [“x64”", “ie. Ty 


“os”: [“darwin”, “linux”] 
还 有 一 些 公 开 的 值 ， 包 括 private， 确 保 程序 不 是 意外 发 布 的 : 
“private”: “true” 


AJAY, publishConfig 用 于 设置 npm MEE. 
截止 目前 我 们 所 做 的 这 些 ，Widget Factory 的 package.json 文件 如 示例 16-1 所 示 : 


示例 16-1 Widget Factory 应 用 的 package.json 文件 
{ 


"name": "WidgetFactory", 
"version": "1.0.0", 
"author": "Shelley Powers <shelley.just@gmail.com> (http://burningbird.net)", 
"description": "World's best Widget Factory", 
"engines": { 
"node"; ">= 0.6.0" 
by 
"dependencies": { 
"express": "3.0", 
"ages TEH, 
"stylus see, 
"redis": “et, 
"mongoose"; "=" 
}, "devDependencies": { 
"nodeunit": "*" 
}y 
"private": true 


} 


我 们 可 以 将 Widget Factory 的 代码 复制 到 一 个 新 的 目录 , 然后 输入 npm install —d 来 
查看 是 否 可 以 安装 所 有 的 依赖 以 及 程序 是 否 运 行 。 通 过 这 种 方式 可 以 测试 
package.json 文件 。 


16.1.2 ”使 用 Forever 让 你 的 应 用 “ 永 不 掉 线 ” 


尽 全 力 使 你 的 程序 完美 。 尽 管 对 程序 进行 了 严格 的 测试 ， 添 加 了 错误 处 理 来 管理 错 
误 信 息 ， 但 是 ,仍然 可 能 出 现 其 他 问题 ， 比 如 你 没有 预料 到 的 事情 使 程序 终止 或 者 
退出 。 如 果 这 种 情况 发 生 ， 你 需要 确保 有 一 种 方式 可 以 重启 程序 ， 即 使 在 你 没 注意 
到 的 情况 下 。 


Forever 就 是 这 样 一 个 工具 。 它 确保 在 程序 前 省 后 重 局 该 程序 。 它 也 是 一 种 按 和 守护 
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进程 模式 在 当前 终端 会 话 后 台 局 动 程序 的 方式 。 


Forever 既 可 以 作为 命令 行 也 可 以 集成 到 程序 中 作为 程序 的 一 部 分 。 如 果 在 命令 行 
上 使 用 ,需要 全 局 安装 : 


npm install forever -g 


然后 不 再 直接 通过 Node 启动 程序 ， 而 是 通过 Forever 启动 : 


forever start -a -1 forever.log -o out.log err.log httpserver.js 


这 个 命令 会 运行 一 个 httpserverjs 的 脚本 ,指定 Forever 的 日 志文 件 , 输出 日 志 以 及 
错误 日 志 ， 如 果 日 志文 件 存在 的 话 也 会 告诉 程序 将 日 志 条 目 添加 到 现 有 文件 里 。 


如 果 脚 本 运行 出 现 问题 导致 程序 骨 演 ，Forever 会 重启 程序 ， 同 时 也 可 以 保障 即使 
关 掉 启动 程序 的 终端 窗口 ，Node 程序 也 可 以 一 直 运 行 。 


Forever 有 选项 和 动作 。 命 令 行 中 的 start 值 是 一 个 动作 。 所 有 可 用 的 动作 如 下 : 
Start 
局 动 脚本 。 
stop 
终止 脚本 。 
stopall 
终止 所 有 脚本 。 
restart 
重启 脚本 。 


restartall 


重启 所 有 运行 中 的 Forever 脚本 。 


cleanlogs 
删除 所 有 日 志 内 容 。 
logs 
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列 出 Forever 所 有 进程 的 所 有 日 志 。 
list 

列 出 所 有 运行 的 脚本 。 
config 

列 出 所 有 用 户 配 置 。 
set<key><val> 

设置 配置 键 值 对 。 
clear<key> 

清除 配置 键 值 对 。 
logs<script|index> 

追踪 <scriptlindex> 的 日 志 。 
columns add <col> 

在 Forever 列表 输出 中 添加 一 列 。 
columnsrm<col> 

从 Forever 列表 输出 中 删除 一 列 。 


columns set <cols> 


设置 Forever 输出 的 所 有 列 。 
httpserver.js 作为 Forever 守护 进程 运行 ， 查 看 后 输出 的 内 容 如 下 : 
info: Forever processes running 
data: uid command script forever pid logfile uptime 
data: [0] ZRYB node httpserver.js 2854 2855/home/examples/.forever/ 


forever.log 0:0:9:38.72 


同样 还 有 相当 多 的 选项 ,包括 讲 到 过 的 日 志文 件 的 设置 ,运行 脚本 ( -s 或 者 --silent ), 
打开 Forever 动态 输出 ( -v 或 者 --verbose ), 设置 脚本 源 代码 目录 (--sourceDir ), 还 
有 其 他 很 多 。 可 以 通过 输入 forever -help 来 查看 具体 内 容 。 


还 可 以 在 程序 中 集成 Forever， 如 程序 文档 中 介绍 的 一 样 : 
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var forever = require('forever'); 


var child = new (forever.Monitor) ('your-filename.js', { 
max: 3, 
silent: true, 
options: [] 


} ) ， 


child.on('exit', this.callback) ; 
child.start (); 


还 可 以 在 Nodemon ( 14 章 中 有 介绍 ) 中 使 用 Forever， 不 仅 可 以 在 出 现 异 党 时 重启 
程序 ， 还 可 以 保证 代码 更 新 时 刷新 程序 。 在 Forever 中 使 用 Nodemon 很 简单 ， 需 要 
--exitcrash 参数 确保 在 程序 前 省 时 Nodemon 退出 ， 将 控制 权 交 给 Forever: 


forever nodemon -exitcrash httpserver.js 


wR, Forever 会 启动 Nodemon, Nodemon 会 按 顺序 执行 Node 脚本 ,不 
仅 确 保 了 如 果 源 代码 变化 运行 脚本 会 更 新 ， 并 且 保 证 了 程序 不 会 因为 意料 之 外 的 错 
误 而 永久 下 线 。 


如 果 和 希望 重启 时 程序 会 自动 启动 ， 则 需要 将 其 设置 为 守护 进程 (daemon )。Forever 
提供 的 例子 中 有 一 个 initd-example。 这 个 例子 是 在 系统 重启 时 用 Forever 运行 你 的 
程序 。 你 需要 修改 该 脚本 来 匹配 你 的 环境 , 同时 将 其 放 在 /etc/init.d 目录 下 。 一 旦 完 
成 之 后 ， 即 使 系统 重新 启动 ， 程 序 也 可 以 不 需要 干涉 而 自动 重启 。 


16.1.3 使 用 Node 和 Apache 


本 书 中 所 有 例子 启动 时 的 端口 都 是 默认 的 网 络 服务 端口 80， 也 有 其 他 一 些 端口 如 
3000 或 者 8124。 在 我 的 系统 中 我 需要 使 用 为 一 个 端口 ， 因 为 Apache 是 通过 80 Mig 
口 处 理 web 请 求 的 。 人 们 在 访问 一 个 网 站 的 时 候 并 不 希望 指定 端口 。 我 们 需要 的 
是 让 Node 程序 与 其 他 服务 右 并 存 ， 比 如 Apache、Nignx。 


如 果 系 统 运行 Apache 并 且 你 没 办 法 修改 Apache 的 端口 ,可 以 使 用 .htaccess 文件 来 重 写 
对 Node 的 Web 请 求 ， 将 这 些 请 求 重 定向 到 合适 的 端口 ， 而 用 户 对 这 一 过 程 并 不 知情 : 


<IfModule mod_rewrite.c> 
RewriteEngine on 


# Redirect a whole subdirectory: 


RewriteRule “node/(.+) http://examples.burningbird.net:8124/$1 [P] 
</IfModule> 
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如 果 你 有 权限 ， 还 可 以 为 Node 程序 创建 一 个 子 域名 并 将 Apache 所 有 请 求 代 理 到 
Node 程序 。 这 是 这 类 型 问题 在 其 他 环境 中 的 解决 办 法 ， 比 如 同时 拥有 Apache 和 


Tomcat: 


<VirtualHost someipaddress: 80> 
ServerAdmin admin@server.com 
ServerName examples.burningbird.net 
ServerAlias www.examples.burningbird.net 


ProxyRequests off 


<Proxy*> 
Order deny,allow 
Allow from all 
</Proxy> 
<Location/> 
ProxyPass http://localhost:8124/ 
ProxyPassReverse http://localhost:8124/ 
</Location> 
</VirtualHost> 


这 种 方式 可 以 工作 。 如 果 不 想 你 的 Node 程序 被 频繁 访问 ， 这 种 方式 下 服务 器 性 能 很 
不 错 。 这 两 种 实现 方式 的 共同 问题 在 于 所 有 的 请 求 都 需要 通过 Apache， 对 每 一 个 请 
求 ，Apache 都 需要 创建 进程 来 进行 处 理 。Node 的 重点 在 于 避免 这 部 分 开销 过 大 。 如 
果 希 望 你 的 Node 程序 被 大 量 使 用 , 另 一 种 实现 方式 也 可 以 完成 , 但 是 这 种 方式 需要 
对 系统 有 root 权限 。 修 改 Apache 的 ports.conf 文件 ， 将 Apache 监听 的 端口 从 : 


Listen 80 
改 为 你 想 要 的 端口 ， 比 如 78: 
Listen 78 
然后 使 用 Node 代理 ， 比 如 http-proxy， 监 听 请 求 并 将 请 求 代 理 到 适当 的 端口 。 比 如 ， 


如 果 Apache 处 理 所 有 对 子 目 录 public 的 请 求 ，Node 处 理 所 有 对 node 的 请 求 ， 需 
要 创建 一 个 独立 的 代理 服务 器 根据 情况 处 理 接收 的 请 求 : 


Var httpProxy = require('http-proxy'); 


var options = { 

router: { 
"bUrningbira.net/public Hhemi*: “127.0.0514-78", 
"burningbird.net/node': '127.0.0.1:3000' 


} 
}; 
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var proxyServer = httpProxy.createServer (options) ; 
proxyServer.listen(80); 


用 户 永 远 也 不 会 看 到 表面 之 后 的 端口 转换 。Http-proxy 模块 也 可 以 用 于 WebSocket 
请 求 和 HTTPS。 


为 什么 要 继续 使 用 Apache 呢 ? 因为 类 似 Drupal 的 应 用 程序 使 用 .htaccess 文件 控制 
对 内 容 的 访问 。 并 且 ， 在 我 的 网 站 中 的 一 些 子 域名 使 用 .htpasswd 来 对 内 容 进 行 密 
码 保护 。 这 些 都 是 Apache 的 设计 ，Node 服务 器 程序 并 没有 等 价 的 概念 。 


我 们 从 很 久 以 前 就 开始 使 用 Apache To Æ Node 程序 中 想 要 弃置 Apache 比 用 
Express 创建 一 个 静态 服务 器 要 复杂 多 了 。 


16.1.4 ”改善 性 能 


ee 你 还 可 以 采取 一 些 步骤 来 提高 Node 应 用 的 性 能 。 这 些 操 作 并 不 麻 
， 但 不 在 本 书 介 绍 范围 之 内 。 


如 果 你 的 系统 是 多 核 的 并 且 和 而 望 答 试 实验 技术 ， 可 以 使 用 Node 集群 (Node 
clustering ), Node.js 文档 包含 一 个 集群 的 例子 ， 尽管 所 有 的 进程 都 在 同一 个 端口 上 
监听 请 求 ， 但 是 每 个 进程 都 分 派 在 不 同 的 CPU Eo 


在 未 来 的 Node 版 本 中 ， 也 许 我 们 可 以 通过 在 启动 程序 时 传递 一 个 balance 参数 来 
自动 利用 多 核 环境 。 


你 还 可 以 使 用 分 布 式 计算 的 架构 ， 比 如 hook.io 模块 。 


dish Node 程序 性 能 ， 大 部 分 需要 花费 一 定 的 工作 量 。 所 
， 你 可 以 将 程序 部 署 在 云 服 务 上 ， 以 充分 利用 云 服务 提供 的 性 能 改善 。 


16.2 部署 到 云 服 务 


现在 越 来 越 受 欢迎 的 方式 是 将 应 用 程序 放 在 云 服务 上 而 不 是 自己 的 主机 上 。 这 样 做 
的 原因 可 能 有 很 多 ， 比 如 以 下 几 个 : 


。 ”安全 性 更 强 《〈 就 像 有 目 己 的 安全 团队 一 样 ); 
。 24 小 时 监控 (所 以 你 可 以 休息 了 ); 
。 即时 扩展 〈 如 果 程 序 突 然 到 达 高 峰 ， 服 务 天 也 不 会 石 机 ); 
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。 化 费 ( 云 服务 右上 的 主机 比 你 自己 的 服务 器 更 便宜 ); 
。 部署 工具 〈 云 提供 了 简化 Node 程序 部 署 的 工具 ); 
。 ”很 潮 〈 列 表 中 唯一 一 个 不 是 为 了 把 Node 应 用 部 署 到 云 服务 上 的 原因 )。 


当然 ， 凡 事 必 有 两 面 性 。 云 服务 的 一 个 缺点 在 于 你 对 程序 的 操作 会 受到 一 定 限 制 。 
比如 , 你 的 程序 需要 使 用 类 似 于 ImageMagick 的 工具 , 但 大 部 分 云 服 务 没 有 安装 这 
个 工具 或 者 不 允许 安装 。 再 比如 ， 程 序 是 基于 Node 6.x (或 者 8.x 或 者 其 他 )， 而 
云 服务 可 能 仅仅 设置 了 另外 一 个 版 本 (如 4.x )。 


将 程序 a e a 一 些 云 服务 提供 了 部 闭 的 工具 ， 
和 目标 和 点 下 按钮 。 而 还 有 一 些 ， 则 需 
须 说 明 ， 可 能 有 也 可 能 没有 容易 阅读 的 文档 。 


在 最 后 一 节 中 ， 我 会 简要 介绍 一 些 常用 的 可 以 提供 Node 程序 宿主 的 云 服 务 ， 并 且 
会 介绍 各 自 不 同 的 特点 。 


16.2.1 通过 Cloud9 IDE 部 署 到 Windows Azure 

如 果 你 的 开发 环境 是 基于 Windows 的 ， 并 且 你 之 前 使 用 过 Windows 的 工具 (比如 
用 .NET 开发 程序 )， 那 么 你 一 定 希 望 将 Node 程序 部 署 到 Windows Azure, X T f 
化 将 Node 程序 部 署 到 Azure 的 过 程 ， 可 以 使 用 Cloud9 IDE ( 集成 开发 环境 ， 
Integrated Development Enviroment ) 来 进行 部 署 。 


Cloud9 是 一 个 基于 web 的 IDE, 相对 于 其 他 IDE 来 说 , 可 以 与 你 的 GitHub 账户 交 
互 。 当 你 打开 程序 时 ， 可 以 看 到 程序 管理 接口 ， 如 图 16-1 所 示 。 











testing only 














16-1 Cloud9 IDE 程序 管理 页 面 
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在 程序 管理 页 面 上 , 以 独立 页 面 方式 打开 一 个 程序 ,可 以 选择 任何 程序 文件 进行 修 
改 ， 如 图 16-2 所 示 。 可 以 在 IDE 中 直接 复制 一 个 GitHub 上 的 工程 。 








2° package gon 


2 Dostreceive sh 
le id 


22 | geryer.je 











16-2 Cloud9 IDE 程序 编辑 页 面 


可 以 添加 并 且 编 辑 文件 ， 然 后 在 IDE 中 和 直接 运行 程序 ，Cloud9 也 支持 调试 功能 。 


Cloud9 IDE 对 于 程序 开发 是 免费 的 , 但 是 如 果 需 要 部 署 则 需要 注册 交 费 。Cloud9 支 
持 很 多 种 语言 ,主要 是 HTML 和 Node 程序 , 同时 也 支持 多 种 程序 源 代码 仓库 ，, 包 
括 GitHub, Bitbucket, Mercurial repository, Git repository 和 FTP 服务 器 。 


Cloud9 IDE 接口 简化 了 将 程序 转移 到 Azure( 还 有 其 他 服务 一 一 稍 后 介绍 ) 的 过 程 。 
如 果 你 已 经 有 了 Azure 账户 ， 部 署 Node 程序 到 Azure 的 过 程 就 仅仅 是 点 击 Deploy 
按钮 ,然后 提供 弹出 对 话 框 所 需要 的 信息 。 预 先 提 示 : 首先 你 需要 熟悉 Azure。 在 提 
交 之 前 有 90 天 的 免费 使 用 ， 可 以 尝试 该 服务 。 


Azure 的 费用 取决 于 服务 器 的 节点 数 ，SQL server 数据 库 节 点 的 大 小 ，blob (二 进 
制 大 对 象 ) 存储 的 数量 以 及 带宽 。Azure 提供 了 一 系列 方便 阅读 的 文档 以 供 入 门 ， 
包括 如 何在 Azure 上 创建 Express 程序 的 教程 。 


我 之 前 提 到 过 Cloud9 IDE 可 以 部 署 在 不 同 的 云 服 务 上 ， 目 前 文 持 以 下 三 种 : 
e Windows Azure 


e Heroku 
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e Joyent 
接 下 来 我 会 介绍 Joyent Development SmartMachine 和 Heroku. 


16.2.2 Joyent Development SmartMachine 

JoyenSmartMachine 是 虚拟 机 ， 可 以 运行 在 Windows 或 者 Linux 下 ， 可 以 对 运行 Node 
程序 进行 预 编 和 优化 。Joyent 开发 人 员 还 提供 了 Node.js Development SmartMachine, 
使 Node 开发 人 员 可 以 免费 在 云 服 务 上 部 署 他 们 的 程序 。 如 果 你 已 经 准备 好 产品 上 线 
了 了 ， 则 可 以 升级 为 产品 环境 。 


Joyent 提供 了 关于 如 何 使 用 Node.js Development SmartMachine 的 详细 文档 ， 包 括 以 
下 步骤 : 


1. 创建 一 个 Joyent 云 服 务 的 账户 ; 

2. 如 果 没 有 的 话 创建 一 个 SSH key; 

3. 更 新 ~/.ssh/config 文件 为 你 的 机 融 配 置 冰 口 号 ; 

4. 用 Git 部 署 程序 到 SmartMachine; 

5， 确 保 程序 包含 package.json 文件 ， 并 指定 启动 脚本 。 

再 强调 一 次 ，Node.js Development SmartMachine 仅 用 于 开发 。 


那么 ，Joyent Development SmartMachine 有 什么 用 呢 ? 好 吧 ， 在 开始 阶段 ， 没 有 前 
期 成 本 。 这 是 很 明智 的 一 步 ， 程 序 员 有 机 会 尝试 云 主机 而 无 需 支 付 可 观 的 费用 。 


Joyent 还 提供 简化 的 Git 部 署 ， 可 以 同时 部 署 到 多 个 机 楷 ， npm 可 以 支持 管理 程序 
的 依赖 。 


16.2.3 Heroku 

我 喜欢 不 需要 任何 费用 就 可 以 试用 的 云 服务 ， 比 如 Heroku 账户 就 是 免费 并 且 即 时 
的 。 如 果 你 决定 使 用 Heroku 作为 你 的 产品 系统 , 像 Azure 一 样 需要 一 些 配置 。Heroku 
的 云 服务 占有 详细 的 文档 ， 也 提供 了 可 以 在 你 的 开发 环境 安装 的 工具 来 简化 部 署 到 
Heroku 的 过 程 ( 如 果 你 没有 使 用 Cloud9 IDE )。 


Heroku 云 服务 还 之 有 一 些 了 预先 打包 好 的 插件 ， 可 以 添加 到 自己 的 账户 ， 包 括 对 我 
最 喜欢 的 数据 存储 Redis 的 支持 。Heroku 对 插件 管理 得 很 好 , 并且 很 多 插件 都 是 人 免 
费 的 。 
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之 前 提 到 过 的 Heroku 的 文档 是 云 服 务 吾 中 文档 最 详尽 的 服务 需 之 一 ， 并 且 开 发 工 
具 也 很 大 程度 上 简化 了 部 署 过 程 。 创 建 好 应 用 程序 ， 编 写 package.json 文件 并 列 出 
依赖 ， 通 过 一 个 简单 的 Procfile ( 内 容 类 似 web: node app.js ) 声明 一 个 进程 类 型 ， 
然后 使 用 Heroku 工具 套件 中 的 某 个 工具 启动 程序 。 

部 署 时 ， 将 程序 提交 到 Git， 然 后 用 Git.Simple 部 署 程序 。 


16.2.4 Amazon EC2 
Amazon Elastic Compute Cloud, 简称 EC2 ， 有 一 定 的 历史 背景 使 它 成 为 一 个 很 受 欢 
迎 的 选择 。 在 EC2 上 部 署 Node 程序 对 开发 人 员 也 没有 太 多 要 求 。 


设置 Amazon EC2 与 设置 传统 的 VPN ( 虚拟 专用 网 络 ，Virtual Private Network ) 没 
有 太 大 区 别 。 指 定 需 要 的 操作 系统 ， 安 装运 行 Node 程序 必须 的 软件 ， 用 Git 部 署 
程序 ， 然 后 使 用 类 似 Forever 的 工具 确保 程序 一 直 在 线 。 


Amazon EC2 服务 提供 了 网 站 , 可 以 简化 设置 节点 的 过 程 。EC2 并 不 像 Joyent 一 样 免 
费 ， 但 是 收费 比较 合理 ， 大 概 是 每 小 时 0.02 美元 。 


16.2.5 Nodejitsu 
Nodejitsu 目前 还 是 测试 版 ， 并 且 提 供 了 测试 账户 。 它 像 很 多 其 他 优秀 的 云 服 务 一 
样 提供 了 免费 试用 。 


Nodejistu 像 Heroku 一 样 提 供 了 简化 部 署 过 程 的 工具 : jistu。 可 以 使 用 npm 安装 ， 
用 jitsu 登录 到 Nodejitsu， 输 入 以 下 命令 就 可 以 进行 部 署 了 : 


Jitsu deploy 


Nodejistu 从 package.json 文件 中 获取 所 需要 的 信息 ,提示 一 些小 的 问题 ,然后 就 可 
AT o 


Nodejistu 也 提供 了 自己 的 基于 Web 的 IDE， 但 是 我 还 没有 试用 过 。 看 起 来 确实 比 
Cloud9 IDE 容易 很 多 。 
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附录 
Node、Git 和 GitHub 


Git 是 一 个 版 本 控制 系统 ， 类 似 于 CVS (Concurrent Versioning System ) 或 者 
Subversion。Git 与 其 他 更 传统 的 版 本 控制 系统 相 比 较 , 不 同 之 处 在 于 当 你 修改 代码 
时 如 何 维 护 源 代码 。 类 似 于 CVS 的 版 本 控制 系统 在 版 本 变化 时 ， 将 变化 作为 与 原 
始 文件 不 同 的 部 分 进行 存储 。 而 Git， 则 是 存储 了 代码 在 某 个 特定 时 间 点 的 快照 。 
如 果 文 件 没 有 修改 ，Git 则 继续 链接 到 之 前 的 快照 上 。 


开始 使 用 Git 前 ， 你 需要 在 你 的 系统 中 进行 安装 。 对 Windows 和 MAC OS 有 二 进 
制 文件 ，Unix 系统 可 以 通过 源 代 码 安 装 。 在 我 的 Linux 服务 器 (Ubuntu 10.04) 上 


安装 Git 只 需要 一 个 命令 : 
sudo apt-get install git 
BTA ROR ABR <> A ol FF AEC 


提示 

之 后 输入 的 命令 行 都 是 假定 你 在 使 用 基于 Unix 的 操作 系统 。Git 在 
Windows 操作 系统 中 有 图 形 界 面 。 你 需要 根据 接口 文档 来 配置 你 的 系 
统 ， 但 是 所 有 环境 中 这 一 基本 过 程 是 相同 的 。 





安装 完 Git 之 后 需要 一 些 配置 。 你 需要 提供 用 户 名 ( 一般 来 说 姓 和 名 字 ) 和 E-mail 
地 址 。 这 两 部 分 是 commit author ( 提交 作者 ) 的 组 成 部 分 ， 用 于 标记 你 的 修改 : 


git config --global user.name “your name” 
git config --global user.email “your email” 


接 下 来 你 需要 使 用 GitHub， 提 供 大 部 分 (如果 不 是 全 部 的 话 ) Node 模块 ， 你 还 需 
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要 创建 GitHub 账户 。 你 可 以 使 用 任何 你 想 用 的 GitHub 用 户 名 一 一 并 不 一 定 和 刚 指 
定 的 用 户 名 一 样 。 你 还 需要 根据 GitHub 帮助 文档 中 的 过 程 为 GitHub 生成 SSH key. 


大 部 分 的 Git 教程 都 是 以 创建 一 个 简单 的 repository ( 更 一 般 的 说 法 是 repo ) 作为 开 
始 的 。 但 是 我 们 感 兴趣 的 部 分 是 如 何在 Git 中 提供 Node 程序 服务 ， 我 们 复制 一 个 
现成 的 repo 而 不 需要 创建 自己 的 。 在 你 复制 源 代码 之 前 ， 首 先 你 需要 在 GitHub 网 
站 的 repository 主页 中 点 击 右 上 和 角 的 fork 按钮 来 fork 一 个 repository( 包含 一 个 项 
目 快 照 )， 如 图 A-1 Bras. 


> shelleyp w o x p 


1> Unwatch & Yourfork <* 634 4 51 


Stats & Graphs 





图 A-1 Æ GitHub 上 fork 一 个 现 有 的 Node 模块 


然后 你 就 可 以 在 自己 的 主页 中 访问 fork 的 repository, 还 可 以 在 新 fork 的 repository 
网 页 上 访问 Git URL. 例如 , FÈ fork 了 node-canvas 模块 (第 12 章 中 讲 到 过 ), URL 
为 git@github.com:shelleyp/node-canvas.git。 在 git 中 复制 fork 的 repository 命令 为 
git clone URL: 


git clone git@github.com:shelleyp/node-canvas.git 


你 还 可 以 通过 HTTP 复制 , 但 是 GitHub 并 不 推荐 这 一 做 法 。 不 过 如 果 你 希望 引入 

在 用 npm 安装 模块 可 能 没有 包含 的 例子 以 及 其 他 内 容 时 ， 这 是 一 种 很 好 的 实现 方 

a ee 可 以 提供 一 个 源 代码 的 只 读 版 本 。 

可 以 从 每 个 repository 的 网 页 上 获取 只 读 的 URL， 对 node-canvas 来 说 命令 如 下 : 
git clone https://github.com:username/node-whatever.git 

提示 

你 可 以 通过 制定 Git URL 的 方式 安装 模块 : 





npm install git://github.com/username/node-whatever.git 
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现在 ， 你 已 经 有 了 一 份 node-canvas ( 或 者 其 他 你 想 要 的 repository ) 代码 的 复 本 。 
你 可 以 修改 任意 你 想 修 改 的 源 文 件 。 通 过 git add 命令 添加 新 增 或 者 修改 后 的 文 
件 ， 然 后 通过 git commit 提交 修改 ( -m 参数 可 以 指定 提交 时 的 信息 ， 比 如 做 了 哪 
些 修改 ): 


git add somefile.js 
git commit -m ‘note about what this change is’ 


如 果 你 想 要 查看 当前 状态 是 否 已 经 可 以 提交 ， 可 以 输入 以 下 命令 
git status 
如 果 你 希望 自己 的 修改 可 以 添加 到 被 fork 的 原 repository 中 ， 你 需要 发 起 pull 


request. ZED Mids PIT IF MK fork 出 来 的 repository 主页 ， 找 到 Pull Request 按钮 ， 
如 图 A-2 所 示 。 








Explore Gist Blog Help step BẸ X X B 





A-2 4 GitHub 上 点 击 Pull Request 按钮 来 发 起 Pull Request 


点 击 Pull Request 按钮 会 打开 一 个 Pull Request 预览 页 面 ， 你 需要 输入 用 户 名 
和 对 修改 的 描述 ， 以 及 哪些 需要 提交 。 这 时 候 你 可 以 修改 提交 范围 和 目标 


repository. 


完成 之 后 发 送 请 求 。 这 样 会 使 Pull Request 中 的 提交 进入 队列 等 待 原作 者 合并 。 原 
作者 可 以 查看 修改 ， 讨 论 一 下 相关 内 容 ， 如 果 决 定 接 受 请 求 ， 会 进行 fetch 操作 合 
并 修改 、 打 补丁 或 者 自动 合并 。 
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提示 
GitHub 有 文档 介绍 如 何 合并 修改 ， 以 及 使 用 Git 的 其 他 功能 。 





如 果 你 创建 了 自己 的 模块 并 希望 与 别人 分 享 ， 你 需要 创建 一 个 repository。 可 以 通 
过 GitHub 来 做 , 点 击 GitHub 网 页 中 的 New Repository 按钮 ， 然后 输入 模块 名 ， 指 
定 repository 访问 权限 为 public (公开 ) 或 者 private (MFA )。 

用 git init 来 初始 化 一 个 空 的 目录 : 


mkdir ~/mybeautiful-module 
cd ~/mybeautiful-module 
git init 


AY DAFA Re AY CABS a HEA repository 提供 一 个 README 文件 。 当 用 户 点 击 
GitHub 模块 页 面 上 的 Read More 的 时 候 会 显示 该 文件 内 容 。 创 建 好 文件 之 后 ， 添 
加 并 提交 : 


git add README 
git commit -m ‘readme commit’ 


为 了 将 本 地 repository 链接 到 GitHub, 你 需要 为 模块 建立 一 个 远 端 repository, 然后 
push Flut repo: 


git remote add origin git@github.com: username/Mybeautiful-Module.git 
git push -u origin master’ 


一 旦 将 新 的 模块 push 到 GitHub ， 你 就 可 以 开始 进行 推广 来 确保 模块 可 以 被 列 在 
Node 模块 列表 和 npm registry 中 。 


你 可 以 在 GitHub 官网 上 Help 链接 下 找到 快速 完成 的 文档 。 
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Shelley Powers 从 事 和 编写 Web 技术 内 容 超过 12 年 了 ， 从 第 一 版 的 JavaScript 发 布 到 最 新 
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REA 


Learning Node 封面 上 的 动物 是 一 只 仓鼠 (Beamys) 。 人 仓鼠 有 两 个 种 类 :大 仓鼠 属 (Beamys 
Major) 和 小 仓鼠 属 (Beamyshindei) 。 


仓鼠 主要 栖息 于 从 肯尼亚 到 坦桑尼亚 的 非洲 处 林 。 这 种 大 型 中 齿 类 动物 喜欢 在 潮湿 的 
环境 安家 : 河 昱 或 者 植被 成 密 的 地 区 。 主 要 繁衍 在 海岸 或 者 山地 地 区 ， 尺 管 森 林 砍 伐 
威胁 到 它们 的 自然 栖息 地 。 仓 鼠 住 在 地 洞 中 ， 非 党 善于 攀 扑 。 

这 种 晓 具 类 动物 外 观 非常 好 辨认 : 7~ 12 瑞 尺 长 ,大 概 三 分 之 一 磅 。 头 很 短 ， 全 里 灰色 
皮毛 ， 肚 皮 是 白色 的 ， RARE. MARI, CRN RAE 
E, CERM RER HT. 


